A personal AI assistant that integrates with popular messaging platforms like WhatsApp, Telegram, Signal, and iMessage. It provides users with AI-powered responses, persistent memory, scheduling capabilities, and access to over 500 third-party applications through integrations, aiming to bring advanced AI functionalities directly into daily communication workflows.

How It Works

The system operates as a unified gateway, connecting to user-specified messaging platforms. It routes incoming messages to a chosen AI provider—either Anthropic's Claude models or open-source alternatives via Opencode. The core logic orchestrates AI responses, manages persistent memory, schedules tasks, and facilitates tool execution through the Composio API, which unlocks over 500 third-party application integrations.

Quick Start & Requirements

• Requirements: Node.js 18+, macOS/Linux/Windows, Anthropic API key (ANTHROPIC_API_KEY), Composio API key (COMPOSIO_API_KEY). Platform-specific: WhatsApp (phone), Telegram (bot token), Signal (signal-cli), iMessage (macOS, imsg CLI).
• Installation: Clone the repository (git clone), install dependencies (npm install). Install AI providers (Claude Code or Opencode).
• API Keys: Obtain and set ANTHROPIC_API_KEY and COMPOSIO_API_KEY as environment variables.
• Quick Start: Run node cli.js for an interactive menu or node cli.js chat/node cli.js start for direct execution.
• Remote Deployment: Recommended via Docker on a Linux VPS (e.g., DigitalOcean $6/month droplet), requiring SSH, Docker, swap memory, cloning, and docker compose up -d.
• Links: Anthropic Console, Composio Dev.

Highlighted Details

• Unified Messaging Interface: Seamlessly interact with AI across WhatsApp, Telegram, Signal, and iMessage.
• 500+ App Integrations: Leverage Composio to connect with services like Gmail, Slack, GitHub, and Notion.
• Persistent Memory: Maintains context through daily logs and long-term user preferences.
• Dual AI Provider Support: Offers flexibility with Anthropic's Claude (Opus, Sonnet, Haiku) and various Opencode models.
• Granular Tool Control: Features an explicit approval system for AI-initiated actions and tool usage.
• Built-in Scheduling: Enables setting reminders and recurring tasks via cron expressions.

Maintenance & Community

Community support is available via a Discord server and X/Twitter updates. Contributions are welcomed through GitHub Issues for bug reports and feature requests, and GitHub Discussions for ideas.

Licensing & Compatibility

The project is released under the MIT license, generally permitting commercial use and integration into closed-source projects, subject to the terms of service for the underlying AI providers and Composio.

Limitations & Caveats

The iMessage integration is exclusive to macOS. Remote deployments require careful configuration of persistent Docker volumes for memory persistence. The setup process, particularly for remote deployment, may require significant system resources and technical expertise, with troubleshooting guides addressing common issues like memory allocation and authentication.