Repolode
anhe2021212-spec

anhe2021212-spec/Tidal_Echo

Claude Code 또는 OpenAI 호환 LLM을 실행해 휴대폰 PWA와 AI 동반자를 연결하는 셀프 호스팅 비공개 1:1 채팅 채널입니다.

스타
326
포크
164
열린 이슈
2
마지막 커밋
지난달

어떤 프로젝트인가요?

Companion Channel은 설치 가능한 휴대폰 웹 앱(PWA)과 사용자의 컴퓨터나 서버에서 실행되는 AI 동반자를 연결하는 1인용 채팅 릴레이입니다. 휴대폰에서 입력한 메시지는 VPS의 SQLite 데이터베이스에 저장된 뒤 Server-Sent Events를 통해 Claude Code 채널 플러그인으로 전달되어 세션에 채널 블록으로 표시됩니다. AI는 reply tool을 통해 답변하고, 답변은 휴대폰에 말풍선으로 나타납니다.

기본 AI 측 구성은 Bun과 MCP로 만든 Claude Code 채널 플러그인입니다. 대체 브리지 스크립트인 examples/bridge_any_llm.py를 사용하면 GPT, DeepSeek, Gemini 등 OpenAI 호환 모델을 Claude Code 대신 사용할 수 있으며, 프런트엔드와 백엔드는 그대로 유지됩니다. 서버 측 API 루프도 포함되어 있어 여러 단계의 MCP 도구 호출, 이미지 및 파일 첨부, 재시작 없이 다시 불러오는 페르소나 파일을 지원합니다.

모든 엔드포인트는 하나의 Bearer 시크릿인 RELAY_SECRET으로 보호되며, 계정이나 서드파티 호스팅은 사용하지 않습니다. 백엔드는 FastAPI이고 앞단에 nginx를 두며, PWA 설치와 Web Push를 위해 HTTPS 도메인이 필요합니다. 음성(MiniMax TTS)과 푸시 알림은 선택 사항이며, 설정하지 않아도 문제없이 비활성화됩니다.

핵심 기능

  • 01SSE와 HTTP를 통해 휴대폰 PWA와 AI 세션 간 메시지를 중계합니다.
  • 02Bun과 MCP 기반 채널 플러그인으로 Claude Code와 연동합니다.
  • 03브리지 스크립트나 서버 측 API 루프를 통해 OpenAI 호환 모델을 지원합니다.
  • 04사용자 서버의 SQLite에 채팅 기록을 저장하고 Bearer 토큰 인증을 적용합니다.
  • 05이미지와 파일 첨부를 처리하며, MCP 도구 호출을 펼쳐 볼 수 있는 카드로 표시합니다.
  • 06선택 사항으로 MiniMax 텍스트 음성 변환과 Web Push 잠금 화면 알림을 지원합니다.

활용 사례

  • 휴대폰에서 Claude Code 기반 AI 동반자와 비공개 1:1 채팅을 이어갑니다.
  • 셀프 호스팅 휴대폰 채팅 UI를 GPT나 DeepSeek 같은 Claude 이외의 LLM에 연결합니다.
  • 재사용 가능한 PWA 셸을 자체 메시지 백엔드의 프런트엔드로 사용합니다.
  • MCP 도구를 호출하고 파일 첨부를 처리하는 서버 측 AI 어시스턴트를 실행합니다.

토픽

자주 묻는 질문

Tidal_Echo은(는) 무엇인가요?
Claude Code 또는 OpenAI 호환 LLM을 실행해 휴대폰 PWA와 AI 동반자를 연결하는 셀프 호스팅 비공개 1:1 채팅 채널입니다. Companion Channel은 설치 가능한 휴대폰 웹 앱(PWA)과 사용자의 컴퓨터나 서버에서 실행되는 AI 동반자를 연결하는 1인용 채팅 릴레이입니다. 휴대폰에서 입력한 메시지는 VPS의 SQLite 데이터베이스에 저장된 뒤 Server-Sent Events를 통해 Claude Code 채널 플러그인으로 전달되어 세션에 채널 블록으로 표시됩니다. AI는 reply tool을 통해 답변하고, 답변은 휴대폰에 말풍선으로 나타납니다.
Tidal_Echo은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
Tidal_Echo은(는) AGPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
Tidal_Echo은(는) 아직 유지보수되고 있나요?
6개월 이내 업데이트. Tidal_Echo의 마지막 커밋은 2026년 9월 22일입니다.
Tidal_Echo은(는) 어디에 사용할 수 있나요?
휴대폰에서 Claude Code 기반 AI 동반자와 비공개 1:1 채팅을 이어갑니다. 셀프 호스팅 휴대폰 채팅 UI를 GPT나 DeepSeek 같은 Claude 이외의 LLM에 연결합니다. 재사용 가능한 PWA 셸을 자체 메시지 백엔드의 프런트엔드로 사용합니다. MCP 도구를 호출하고 파일 첨부를 처리하는 서버 측 AI 어시스턴트를 실행합니다.
Tidal_Echo은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/anhe2021212-spec/Tidal_Echo

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트