Summary

HermesPet is a native macOS AI chat client and desktop companion that deeply integrates AI into the user's workflow. It targets MacBook users seeking an interactive, zero-dependency AI assistant that leverages macOS features like the Dynamic Island, offering parallel multi-engine support and unique desktop pet companions for enhanced productivity.

How It Works

This SwiftUI application runs from the menu bar, offering a summoned chat window. Its core innovation is true parallel execution of multiple AI engines for concurrent tasks, not sequential switching. It deeply integrates with macOS, using the Dynamic Island for real-time status and notifications. Interactive pixel art desktop pets accompany different AI modes, capable of file interaction. Advanced capabilities are unlocked by installing optional command-line tools.

Quick Start & Requirements

• Install: Download the Apple-notarized DMG from GitHub Releases for a simple, double-click installation. Build from source using install.sh for developers (macOS 14+, Xcode command-line tools required).
• Requirements: macOS 14.0+ is mandatory. Optional CLI tools (Claude, Codex, OpenClaw) unlock advanced features.
• Links: GitHub Releases, Project Homepage.

Highlighted Details

• Parallel AI Execution: Supports up to 8 concurrent AI conversations across 5 distinct engines for simultaneous tasks.
• Dynamic Island Integration: Leverages the notch for real-time status, tool feedback, and notifications.
• Interactive Desktop Pets: 5 unique pixel art companions tied to AI modes, capable of file interaction and UI animations.
• Advanced Input/Output: Push-to-talk voice input (⌘⇧V) with real-time transcription, drag-and-drop file handling for AI processing, and PDF reading with OCR.
• Cross-AI Context Sharing: Seamlessly transfers conversation history between different AI engines when switching modes.
• Local Memory & Task Planning: AI assists in task planning via actionable cards and maintains cross-day memory/daily recaps, all stored locally.

Maintenance & Community

Independently maintained by Basion Wang (@basionwang-bot) with active development. Community interaction via GitHub Issues. Direct email for collaboration.

Licensing & Compatibility

Licensed under Apache License 2.0. Requires retaining copyright notices and marking modifications. Prohibits using project name/trademark/logo to imply endorsement. Generally permissive for commercial use.

Limitations & Caveats

Requires macOS 14.0+. Advanced AI engine capabilities necessitate installing separate command-line tools. Users are cautioned against unofficial versions due to security risks. Independently maintained, implying a potential bus factor.