Ctrl K
ComunidadGuías…
GITHUB · ANALIZADO

telegramcode

TelegramCode es un bot de Telegram que funciona como terminal para OpenCode y Claude Code, permitiendo ejecutar agentes en tu propia máquina o VPS con interfaz de chat y control por voz.

Ficha actualizada 22 sept 2026, 18:39 · upstream 22 sept 2026, 17:21 · release v2.0.3

Ver códigoProblemas y ayudaRepositorio ↗
00

Qué es telegramcode

Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.

TelegramCode transforma el Telegram en una terminal para ejecutar CLIs agentic. Se puede instalar como CLI local o desplegar en un servidor remoto (VPS/VDS). Permite múltiples pestañas por proyecto, control por voz desde el teléfono o tablet, sin necesidad de abrir puertos ni dashboards complejos.

CASOS DE USO
  • Ejecutar agentes de IA (OpenCode/Claude Code) como terminal en tu máquina local
  • Despliegue de bot Telegram con múltiples pestañas por proyecto
  • Control de agentes mediante voz desde el teléfono o tablet
  • Automatización de tareas repetitivas con cron jobs y self-driving agents
  • Gestión de proyectos con archivos adjuntos (fotos, documentos) enviados a los agentes
  • Colaboración remota entre desarrolladores usando Telegram como canal de trabajo
PUNTOS DESTACADOS
  • Soporta múltiples pestañas por proyecto: hasta dos temas por proyecto para trabajar en paralelo
  • Permite ejecutar OpenCode y Claude Code directamente desde Telegram sin necesidad de un servidor dedicado
  • Incluye transcripción de voz mediante Whisper (preferiblemente Groq) o OpenAI
  • Sistema de notificaciones que pincea mensajes cuando el agente hace preguntas, incluso en temas silenciados
  • Soporta ejecución cron y self-driving: los agentes pueden programar sus propios jobs recurrentes
  • Permite enviar archivos generados (gráficos, logs, PDFs) directamente a Telegram como respuesta
  • Configuración simple con un solo archivo .env que contiene el token del bot y la clave de API de Groq
PRECAUCIONES
  • El uso de Groq para transcripción de voz requiere una API key gratuita limitada (10,000 caracteres/día)
  • La ejecución local depende de que la máquina esté encendida; no funciona en modo sleep
  • Los agentes ejecutados localmente son solo accesibles desde el dispositivo donde corre el bot
  • El uso de OpenCode requiere un servidor HTTP con SSE y puede consumir recursos del sistema operativo
  • No incluye autenticación de usuarios para los agentes (OpenCode usa su propio token)
  • La transcripción por voz tiene latencia debido a la necesidad de enviar audio al API externo
01

Perfil de infraestructura

Estimación inicial derivada del repositorio y de los servicios detectados.

CPU2 vCPUrecomendación inicial
MEMORIA2 GBRAM estimada
DISCO10 GBalmacenamiento base
COMPLEJIDADmediumnivel de operación
02

Despliegue detectado

Qué señales reales de instalación hemos encontrado.

Listo para automatizar

Para producción, despliega el bot en un servidor VPS con Docker Compose. Configura variables de entorno para el token del bot y la clave de Groq. Usa un grupo de chats como supergrupo para los temas y el DM del administrador como superficie alternativa. Para múltiples instancias en el mismo host, usa contenedores separados con tokens distintos. La ejecución local es ideal para prototipado rápido, pero la versión desplegada ofrece escalabilidad y acceso remoto desde cualquier dispositivo.

✓Dockerfile
✓Compose
✓One-click
03

Stack y dependencias

Componentes inferidos a partir de manifests, configuración y documentación.

FRAMEWORKS
Next.jsNode.js
SERVICIOS
No detectados
BASES DE DATOS
No detectadas
PUERTOS
4096
05

Puede sustituir a

Relaciones detectadas por el análisis del repositorio y su categoría.

06

Experiencia real de la comunidad

Ayuda a contrastar la estimación automática con instalaciones reales.

Todavía no hay datos comunitarios para este proyecto.