# Tidal Echo

> Self-hosted, open-source private chat connecting a mobile PWA to your local AI via your own relay server — no accounts, no third-party hosting.

- **Category:** Chat
- **Licence:** AGPL-3.0
- **Open source:** oss
- **Languages:** Python, HTML
- **Platforms:** Python, Bun, Build from Source
- **Tags:** SQLite, Privacy, Mcp, Ai Agents, Chatbot, Sse, Web Push, Pwa, LLM, Bun, Fastapi, Self Hosted, Claude code, Personal ai, Ai companion, Private Chat, Minimax TTS

## Description

Tidal Echo builds a private one-to-one messaging link between a person and their AI companion. Three self-hosted pieces make it work: a relay backend (FastAPI + SQLite) on a VPS behind nginx with HTTPS, a progressive web app served as static files that installs on mobile home screens, and a local AI bridge — either a Claude Code channel plugin (Bun) or a server-side API loop that works with any OpenAI-compatible model and adds multimodal input, MCP tool calling, and persona hot-reload. Everything uses one shared Bearer secret, no accounts. Optional MiniMax TTS gives spoken replies; optional Web Push (VAPID) sends lock-screen notifications. Licensed AGPL-3.0.

## Links

- [Homepage](https://github.com/anhe2021212-spec/tidal_echo)
- [GitHub Repository](https://github.com/anhe2021212-spec/Tidal_Echo)
- [Backend Deployment Guide](https://github.com/anhe2021212-spec/Tidal_Echo/blob/main/backend/DEPLOY.md)
- [Frontend PWA Deployment Guide](https://github.com/anhe2021212-spec/Tidal_Echo/blob/main/web/DEPLOY.md)
- [Channel Plugin Deployment Guide](https://github.com/anhe2021212-spec/Tidal_Echo/blob/main/channel/DEPLOY.md)
- [Examples & API Loop Documentation](https://github.com/anhe2021212-spec/Tidal_Echo/blob/main/examples/README.md)

---
Source: https://selfhost.directory/project/tidal-echo