Repolode
Enviar
anhe2021212-spec

anhe2021212-spec/Tidal_Echo

Canal de chat privado 1:1 autoalojado que conecta una PWA para el teléfono con tu compañero de IA, con Claude Code o cualquier LLM compatible con OpenAI.

Ver en GitHub
Estrellas
326
Forks
164
Issues abiertos
2
Último commit
el mes pasado

¿Qué es?

Companion Channel es un relé de chat para un solo usuario que conecta una aplicación web instalable para el teléfono (PWA) con un compañero de IA que se ejecuta en tu propio equipo o servidor. Los mensajes que escribes en el teléfono se guardan en una base de datos SQLite en tu VPS y se envían mediante Server-Sent Events a un plugin de canal de Claude Code, que los muestra como bloques de canal en una sesión. La IA responde mediante una herramienta de respuesta, y su mensaje aparece como una burbuja en el teléfono.

La opción predeterminada para el lado de la IA es un plugin de canal de Claude Code desarrollado con Bun y MCP. Un script de puente alternativo, examples/bridge_any_llm.py, permite usar cualquier modelo compatible con OpenAI (GPT, DeepSeek, Gemini y otros) en lugar de Claude Code, sin cambiar el frontend ni el backend. También se incluye un ciclo de API en el servidor, con llamadas a herramientas MCP en varios pasos, archivos adjuntos e imágenes, y un archivo de personalidad que se vuelve a cargar sin reiniciar.

Todos los endpoints están protegidos por un único secreto Bearer, RELAY_SECRET, y no hay cuentas ni servicios de hosting de terceros. El backend usa FastAPI, con nginx delante, y requiere un dominio con HTTPS para instalar la PWA y usar Web Push. La voz (MiniMax TTS) y las notificaciones push son opcionales y se desactivan correctamente si no están configuradas.

Funciones clave

  • 01Transmite mensajes entre una PWA para el teléfono y una sesión de IA mediante SSE y HTTP.
  • 02Se integra con Claude Code mediante un plugin de canal desarrollado con Bun y MCP.
  • 03Admite cualquier modelo compatible con OpenAI mediante un script de puente o el ciclo de API en el servidor.
  • 04Guarda el historial del chat en SQLite en tu propio servidor, con autenticación mediante token Bearer.
  • 05Gestiona imágenes y archivos adjuntos; las llamadas a herramientas MCP se muestran en tarjetas desplegables.
  • 06Incluye, de forma opcional, conversión de texto a voz con MiniMax y notificaciones Web Push en la pantalla de bloqueo.

Casos de uso

  • Mantener desde el teléfono un chat privado individual con un compañero de IA basado en Claude Code.
  • Conectar una interfaz de chat móvil autoalojada a un LLM distinto de Claude, como GPT o DeepSeek.
  • Usar una estructura PWA reutilizable como frontend para tu propio backend de mensajes.
  • Ejecutar un asistente de IA en el servidor que utilice herramientas MCP y gestione archivos adjuntos.

Temas

#ai-companion#claude-code#llm#pwa#self-hosted#chatbot#mcp#privacy#ai-agents#personal-ai

Preguntas frecuentes

¿Qué es Tidal_Echo?
Canal de chat privado 1:1 autoalojado que conecta una PWA para el teléfono con tu compañero de IA, con Claude Code o cualquier LLM compatible con OpenAI. Companion Channel es un relé de chat para un solo usuario que conecta una aplicación web instalable para el teléfono (PWA) con un compañero de IA que se ejecuta en tu propio equipo o servidor. Los mensajes que escribes en el teléfono se guardan en una base de datos SQLite en tu VPS y se envían mediante Server-Sent Events a un plugin de canal de Claude Code, que los muestra como bloques de canal en una sesión. La IA responde mediante una herramienta de respuesta, y su mensaje aparece como una burbuja en el teléfono.
¿Tidal_Echo es gratuito? ¿Qué licencia tiene?
Tidal_Echo es open source bajo la licencia AGPL-3.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿Tidal_Echo sigue mantenido?
Actualizado en los últimos 6 meses. El último commit de Tidal_Echo fue el 22 sept 2026.
¿Para qué puedo usar Tidal_Echo?
Mantener desde el teléfono un chat privado individual con un compañero de IA basado en Claude Code. Conectar una interfaz de chat móvil autoalojada a un LLM distinto de Claude, como GPT o DeepSeek. Usar una estructura PWA reutilizable como frontend para tu propio backend de mensajes. Ejecutar un asistente de IA en el servidor que utilice herramientas MCP y gestione archivos adjuntos.
¿Dónde consigo Tidal_Echo?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/anhe2021212-spec/Tidal_Echo

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados