Agent2Telegram

Agent2Telegram

[](https://github.com/petrludwig-collab/Agent2Telegram/actions/workflows/ci.yml)   

Talk to your coding agent — **Claude Code** or **Codex** — from **Telegram**.

Agent2Telegram is a tiny, dependency‑free bridge. It long‑polls Telegram for messages from **you** (and only you), hands each one to the agent CLI of your choice, and sends the reply back. No public IP, no webhook, no cloud — it runs on your own machine, behind your router.

Telegram  ⇄  Agent2Telegram  ⇄  claude / codex

**What you can send:** plain text, **images** and **files** (downloaded and handed to the agent), and **voice messages** — transcribed automatically when you add your own ElevenLabs key (see *Voice messages* below).

---

Why it’s built this way

• Robust by default — one bad message never crashes the loop; network errors, Telegram flood‑control (429), 4096‑char limits and Markdown parse failures are all handled.
• Secure — the agent can run code on your machine, so only allow‑listed Telegram users can drive it. Everyone else is politely refused.
• Zero install friction — the core uses only the Python standard library. Nothing to pip install for it to work, which means far fewer “it doesn’t run on my machine” moments.
• Works behind NAT — long polling, so no port‑forwarding or domain needed.

---

Quick start

# 1) Get the code
git clone https://github.com/petrludwig-collab/Agent2Telegram.git
cd Agent2Telegram

# 2) Run the setup wizard (pick agent → paste token → authorize yourself)
python3 -m agent2telegram setup

# 3) Start the bridge
python3 -m agent2telegram run

…or the one‑liner:

curl -fsSL https://raw.githubusercon