Takopi is a Telegram bridge for AI coding assistants (Codex, Claude, OpenCode, Pi), streamlining multi-project management and AI interaction. It targets developers needing to juggle repositories, branches, and AI tasks, offering enhanced productivity through seamless session resumption and progress streaming.

How It Works

The system utilizes Git worktrees for simultaneous multi-repo/branch development. Its core advantage is stateless session management, enabling task resumption within Telegram or the terminal. Real-time progress streaming for commands, tools, and file changes provides immediate feedback, complemented by parallel agent execution and per-session queuing.

Quick Start & Requirements

• Primary install / run command (pip, Docker, binary, etc.).
  • Install uv (script provided), then uv tool install -U takopi.
  • Run takopi for initial bot token, chat, and engine setup.
• Non-default prerequisites and dependencies (GPU, CUDA >= 12, Python 3.12, large dataset, API keys, OS, hardware, etc.).
  • Python 3.14+ required.
  • At least one AI engine (codex, claude, opencode, or pi) must be on the PATH.
• Estimated setup time or resource footprint.
  • Not specified.
• If they are present, include links to official quick-start, docs, demo, or other relevant pages.
  • User Guide: docs/user-guide.md
  • Plugins: docs/plugins.md, docs/public-api.md
  • Development: docs/specification.md, docs/developing.md

Highlighted Details

• Simultaneous project and Git worktree management for multiple repositories/branches.
• Stateless resume capability for continuing tasks across Telegram and terminal environments.
• Real-time progress streaming for commands, tools, and file operations.
• Extensible via entrypoint-based plugins for engines, transports, and commands.

Maintenance & Community

• Community support available via the takopi dev telegram group.
• Development specifications and contribution guides are in docs/specification.md and docs/developing.md.

Licensing & Compatibility

• License type and notable restrictions (GPL -> copyleft, SSPL, etc.).
  • No license information is provided in the README.
• Compatibility notes for commercial use or closed-source linking.
  • Not specified.

Limitations & Caveats

Requires Python 3.14+. Functionality is dependent on external AI model APIs and Telegram integration. Specific unsupported platforms or known bugs are not detailed in the provided README.