Talon

Frameworks & SDKs 💻 TypeScript ⚖️ MIT 🟢 Actively maintained
75 stars

Talon is a multi-platform agentic AI harness that runs on Telegram, WhatsApp, Discord, Microsoft Teams, the Terminal, and a companion app, with pluggable backends like Claude Agent SDK, Kilo, OpenCode, Codex, or OpenAI Agents. It solves the problem of deploying and managing AI agents across multiple chat platforms with full tool access via MCP. It is for developers who want to build and run autonomous agents that interact with users on various messaging platforms.

✨ Key features

  • Multi-frontend support: Telegram, WhatsApp, Discord, Teams, Terminal, and Flutter app.
  • Pluggable backends: Claude Agent SDK, Kilo, OpenCode, Codex, OpenAI Agents.
  • MCP tools for messaging, media, history, search, web fetch, cron, triggers.
  • Hot-reloadable plugin system with install/enable/disable commands.
  • Background agents: heartbeat and dream for proactive goals and memory consolidation.
  • Goals, skills, triggers, and task table for persistent agent workflows.

🎯 Use cases

  • Deploy an AI assistant on Telegram or WhatsApp for personal or group chats.
  • Run autonomous agents that execute goals and send proactive messages.
  • Integrate with MCP tools to access files, web, and external services.
  • Build custom plugins and skills to extend agent capabilities.
  • Manage multiple frontends simultaneously with a single backend.

📦 Installation

🧰 Requirements: Requires Bun 1.3+ or Node.js 24+, and backend-specific credentials (e.g., Claude Code CLI for claude backend, or codex CLI for codex backend).

git clone https://github.com/dylanneve1/talon.git && cd talon
npm install
Interactive setup (select frontend, configure tokens, pick model)
npx talon setup
Start
npx talon start       # configured frontend (daemon mode)
npx talon chat        # terminal chat mode

Alternatively, install via Homebrew (macOS/Linux): brew install dylanneve1/talon/talon or download a standalone binary from releases.

🚀 Usage

After setup, start the bot in daemon mode
npx talon start
Or use terminal chat mode
npx talon chat

❓ FAQ

What runtimes are supported?

Talon requires Bun 1.3+ or Node.js 24+. It runs TypeScript sources directly, with Bun as the primary runtime and Node via a tsx loader.

Which backends can I use?

You can choose from Claude Agent SDK, Kilo, OpenCode, Codex, or OpenAI Agents. The backend is selectable per-process via the 'backend' config.

Can I run multiple frontends at once?

Yes, you can specify an array of frontends in the config, e.g., ["telegram", "whatsapp", "native"], and each chat id routes to its owning frontend.

How do I install plugins or skills?

Use commands like talon plugin install/enable/disable and talon skill install/enable/disable. Plugins can be from npm, git, or local sources; skills can be local folders, git, or owner/repo.

📊 Repository

Stars★ 75
Forks🍴 2
Open issues🐛 5
Last commit🕒 Sep 4, 2026
Created📅 Mar 2026
Language💻 TypeScript
License⚖️ MIT

🤖 Overview, features, install steps and FAQ were generated from the project's README on Sep 4, 2026. Always check the original source before running commands.