codex-telegram-bridge
Puente oficial para Telegram que conecta la CLI de OpenAI Codex con bots de Telegram, permitiendo chats persistentes multi-turno sin usar API Keys pagadas por mensaje.
Ficha actualizada 24 sept 2026, 5:03 · upstream 24 sept 2026, 4:29 · release sin release detectada
Qué es codex-telegram-bridge
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este proyecto actúa como interfaz persistente entre la CLI de OpenAI Codex y Telegram, eliminando la necesidad de pagar por API Keys pagadas por mensaje (metered). A diferencia de wrappers que ejecutan `codex exec` para cada mensaje, mantiene un proceso `codex app-server` vivo por usuario de Telegram. Esto permite que los hilos de conversación sobrevivan a reinicios del sistema y que los turnos completados se entreguen como mensajes normales con logs colapsables opcionales.
La arquitectura soporta aislamiento multi-cuenta mediante espacios de trabajo separados (`CODEX_HOME`) y procesos independientes, permitiendo que cada usuario tenga sus propias cuotas de suscripción, modelos y políticas de sandbox. El instalador automatizado configura systemd units, gestiona tokens en archivos `.env` con permisos seguros (600) y soporta un servidor local opcional para archivos grandes (hasta 2GB vs 20MB nativo).
- Desarrollo colaborativo donde varios programadores usan el mismo bot Telegram con suscripciones Codex individuales.
- Soporte técnico automatizado que entrega código generado directamente en chats de Telegram con logs del proceso.
- Prototipado rápido donde se compilan mensajes consecutivos (inclidos forwards) en un único prompt para ahorrar tokens.
- Entornos empresariales que requieren aislamiento estricto entre usuarios mediante `whitelist.txt` y políticas de sandbox por cuenta.
- Aislamiento multi-cuenta real con procesos separados y cuotas independientes verificables vía `/usage`.
- Soporte nativo para archivos locales (fotos, documentos) pasados como inputs `localImage` a Codex.
- Gestión segura de tokens en `.env` con permisos 600 y never embedded en systemd units.
- Capacidad de manejar archivos grandes mediante servidor local opcional (2GB vs 20MB nativo).
- Cancelación limpia de turnos activos vía `/stop` sin perder contexto previo.
- Requiere Linux con Python 3.10+ y systemd; no soporta Windows o macOS nativamente.
- Dependencia externa obligatoria: la CLI de OpenAI Codex debe estar instalada y autenticada previamente.
- El servidor local opcional requiere configuración manual de `api_id` y `api_hash` en archivos protegidos.
- No incluye Docker ni Compose; despliegue manual vía systemd units y scripts bash.
- Los usuarios adicionales requieren acceso a la máquina para ejecutar `/login` y configurar sus cuentas.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Despliega como servicio systemd con permisos estrictos en `.env` (600). Verifica instalación con `./doctor.sh`. Para archivos grandes, activa servidor local opcional (`setup.sh` sin parámetros vacíos) o usa API cloud nativa. Asegura que `accounts/<id>/` sea writable por el usuario del servicio. Usa `request-restart` para reinicios seguros tras turnos activos.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
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.