Chat with GPT-5, Claude Sonnet 4, o3, and more — directly from Telegram. Extend with plugins for Gmail, Google Calendar, or build your own.
npm install -g @hmawla/co-assistant
Click to copy
A complete AI assistant framework — batteries included, infinitely extensible.
Switch between GPT-5, Claude Sonnet 4, o3, and 10+ models on the fly. Premium, standard, and free tiers.
Isolated, sandboxed plugins with auto-disable on failure. Built-in Gmail and Google Calendar. Create your own in minutes.
Full Telegram bot with Markdown formatting, message threading, and command handling. Feels like chatting with a friend.
Scheduled AI prompts that proactively check your inbox, calendar, or any custom task — and message you in Telegram.
Multiple parallel AI sessions so messages never queue. Concurrent conversations handled seamlessly.
Interactive setup wizard, plugin management, model switching, and heartbeat control — all from the command line.
Automatic update checks via heartbeat. One-tap "Update Now" button in Telegram installs and restarts — zero downtime.
13 models across 4 tiers. Switch anytime with a single command.
First-party plugins included. Build custom integrations with a simple interface.
Search, read, and send emails. Thread-aware inbox analysis with reply detection.
List, create, update, and delete calendar events. Full OAuth integration.
Export a createPlugin() function with tools, and drop it in the
plugins/ directory. That's it.
Three steps. No boilerplate, no config files to write by hand.
Install globally from npm. Works on Linux, macOS, and Windows.
npm install -g @hmawla/co-assistant
The interactive wizard walks you through every credential and preference.
mkdir my-bot && cd my-bot
co-assistant setup
Launch the bot. Open Telegram, send a message. That's it.
co-assistant start