whatisgithub

What is claudegram?

fcecin/claudegram — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · developerComplexity · 4/5Setup · hard

In one sentence

A Telegram bridge that lets you control a fully autonomous Claude Code instance from your phone by voice or text, meant only for an isolated, low-risk machine.

Mindmap

mindmap
  root((claudegram))
    What it does
      Voice or text to Claude Code
      Local transcription
      Streams answers back
      Photo input support
    Tech stack
      Python
      Telegram bot
      faster-whisper
      Kokoro TTS
    Use cases
      Drive coding tasks remotely
      Talk to Claude by voice
      Monitor long running tasks
    Audience
      Developers
      Vibe coders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Talk to a Claude Code instance by voice or text from your phone away from your desk.

USE CASE 2

Send a screenshot or photo and have Claude look at it directly in the conversation.

USE CASE 3

Get spoken voice replies read back to you instead of reading text on screen.

USE CASE 4

Keep a long running coding task going and get notified when Claude needs attention.

What is it built with?

PythonTelegramfaster-whisperKokoro

How does it compare?

fcecin/claudegram0xhassaan/nn-from-scratch3ks/embedoc
Stars00
LanguagePythonPythonPython
Last pushed2023-06-08
MaintenanceDormant
Setup difficultyhardmoderatehard
Complexity4/54/51/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Runs Claude Code with full permission bypass, the author warns to only use it on an isolated machine with no sensitive data or credentials.

No license information is provided in the README.

So what is it?

Claudegram is a private Telegram bridge that lets you control a Claude Code coding assistant instance from your phone using voice or text messages. You talk to your own Telegram bot, it transcribes your voice locally on your machine, echoes back what it heard, sends the request to a Claude Code instance running on your computer, and streams back everything Claude does along with its final answer, all while sitting in your system tray. The README opens with a serious warning that this tool runs Claude Code with full permissions bypassed, meaning it can run any shell command and read, edit, or delete any file on the machine as your own user account, triggered remotely by anyone who can message the bot. Because of this, the author strongly recommends only running claudegram on a separate, isolated machine that holds no sensitive credentials, cloud logins, password managers, browser sessions, crypto wallets, or personal documents, since the built-in safety features are described as guardrails rather than a true sandbox. Features include local voice transcription using an open source speech model, sending photos or images for Claude to look at directly, spoken voice replies using an offline text-to-speech engine, batching multiple quick messages into one request, and streaming Claude's answer back in readable chunks as it writes. A live activity board shows what Claude is currently doing, such as running commands or reading files, and a watchdog process keeps checking in on long running background tasks so nothing gets silently forgotten. The bridge is locked to a single allowed Telegram account, uses your existing Claude subscription rather than a separately billed API key, and includes a firewall style guard meant to detect and block genuine hacking attempts made through the bot, plus a stricter tripwire that locks everything down if any other person messages the bot at all.

Copy-paste prompts

Prompt 1
Explain the security risks of running claudegram with bypassPermissions before I set it up.
Prompt 2
Walk me through setting up claudegram on an isolated machine using install-manual.md.
Prompt 3
Help me understand what the hacking firewall and intrusion lock features actually protect against.
Prompt 4
Show me how voice transcription and voice replies work together in claudegram.

Frequently asked questions

What is claudegram?

A Telegram bridge that lets you control a fully autonomous Claude Code instance from your phone by voice or text, meant only for an isolated, low-risk machine.

What language is claudegram written in?

Mainly Python. The stack also includes Python, Telegram, faster-whisper.

What license does claudegram use?

No license information is provided in the README.

How hard is claudegram to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is claudegram for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.