Repolode
Предложить
anhe2021212-spec

anhe2021212-spec/Tidal_Echo

Личный self-hosted чат 1:1, связывающий PWA на телефоне с AI-компаньоном, запущенным через Claude Code или любую LLM с совместимым с OpenAI API.

Открыть на GitHub
Звёзды
326
Форки
164
Открытые issues
2
Последний коммит
в прошлом месяце

Что это?

Companion Channel — это чат-релей для одного пользователя, который связывает устанавливаемое веб-приложение (PWA) на телефоне с AI-компаньоном, запущенным на вашем компьютере или сервере. Сообщения, набранные на телефоне, сохраняются в базе SQLite на вашем VPS и передаются через Server-Sent Events плагину каналов Claude Code, где отображаются как блоки канала в сессии. AI отвечает с помощью инструмента ответа, и ответ появляется на телефоне в виде сообщения.

По умолчанию на стороне AI используется плагин каналов Claude Code на Bun и MCP. Альтернативный скрипт-мост examples/bridge_any_llm.py позволяет заменить Claude Code любой моделью с совместимым с OpenAI API (GPT, DeepSeek, Gemini и другими), не меняя фронтенд и бэкенд. Также предусмотрен серверный цикл API с многошаговыми вызовами инструментов MCP, вложениями изображений и файлов и файлом персоны, который перечитывается без перезапуска.

Все эндпоинты защищены одним секретом Bearer — RELAY_SECRET; учётных записей и стороннего хостинга нет. Бэкенд написан на FastAPI, перед ним работает nginx. Для установки PWA и Web Push требуется домен с HTTPS. Голос (MiniMax TTS) и push-уведомления необязательны и корректно отключаются, если не настроены.

Ключевые возможности

  • 01Передаёт сообщения между PWA на телефоне и AI-сессией по SSE и HTTP.
  • 02Интегрируется с Claude Code через плагин каналов на Bun и MCP.
  • 03Поддерживает любые модели с совместимым с OpenAI API через скрипт-мост или серверный цикл API.
  • 04Хранит историю чата в SQLite на вашем сервере с аутентификацией по Bearer-токену.
  • 05Поддерживает изображения и вложения файлов; вызовы инструментов MCP отображаются в виде раскрывающихся карточек.
  • 06Необязательные озвучивание текста через MiniMax и уведомления Web Push на экране блокировки.

Сценарии использования

  • Личная переписка 1:1 с AI-компаньоном на базе Claude Code с телефона.
  • Подключение self-hosted интерфейса чата на телефоне к LLM, отличной от Claude, например GPT или DeepSeek.
  • Использование готовой оболочки PWA как фронтенда для собственного бэкенда сообщений.
  • Запуск серверного AI-помощника, который вызывает инструменты MCP и обрабатывает вложения файлов.

Темы

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

Частые вопросы

Что такое Tidal_Echo?
Личный self-hosted чат 1:1, связывающий PWA на телефоне с AI-компаньоном, запущенным через Claude Code или любую LLM с совместимым с OpenAI API. Companion Channel — это чат-релей для одного пользователя, который связывает устанавливаемое веб-приложение (PWA) на телефоне с AI-компаньоном, запущенным на вашем компьютере или сервере. Сообщения, набранные на телефоне, сохраняются в базе SQLite на вашем VPS и передаются через Server-Sent Events плагину каналов Claude Code, где отображаются как блоки канала в сессии. AI отвечает с помощью инструмента ответа, и ответ появляется на телефоне в виде сообщения.
Tidal_Echo можно использовать бесплатно? Какая у него лицензия?
Tidal_Echo распространяется с открытым исходным кодом под лицензией AGPL-3.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.
Tidal_Echo всё ещё поддерживается?
Обновлялся за последние 6 месяцев. Последний коммит в Tidal_Echo — 22 сент. 2026 г..
Для чего можно использовать Tidal_Echo?
Личная переписка 1:1 с AI-компаньоном на базе Claude Code с телефона. Подключение self-hosted интерфейса чата на телефоне к LLM, отличной от Claude, например GPT или DeepSeek. Использование готовой оболочки PWA как фронтенда для собственного бэкенда сообщений. Запуск серверного AI-помощника, который вызывает инструменты MCP и обрабатывает вложения файлов.
Где скачать Tidal_Echo?
Исходный код и инструкции по установке — на GitHub: https://github.com/anhe2021212-spec/Tidal_Echo

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты