Skip to main content

​
Welcome to EchOS

EchOS is a personal AI knowledge system — self-hosted, agent-driven, and always private. It captures, organizes, and retrieves your knowledge through natural conversation across Telegram, the web, and the terminal.
EchOS is a personal project — built for one user, deployed on your own infrastructure. It is intentionally not multi-tenant.

​
What it feels like

You’re walking and a thought hits. You open Telegram and say it out loud. Thirty seconds later it’s in your knowledge base — transcribed, categorized, tagged, searchable. No app to open. No form to fill. No friction.

​
Key features

  • Capture without friction — Text, URLs, voice messages, photos. Through Telegram, the terminal, or the web.
  • Semantic search — Hybrid full-text and vector search. Ask a question the way you’d ask a person.
  • Write in your voice — Blog posts, threads, emails grounded in your notes, in your writing style.
  • Obsidian-compatible — Every note is a plain .md file. Open $ECHOS_HOME/knowledge/ in Obsidian (defaults to ~/echos/knowledge/) and it just works.
  • Plugin system — YouTube transcripts, article extraction, and you can build your own.

​
Quick start

Homebrew (macOS)
One-liner (macOS + Linux)
Manual
You’ll need an LLM API key — either Anthropic (ANTHROPIC_API_KEY) or any provider supported by pi-ai (LLM_API_KEY). Custom OpenAI-compatible endpoints are supported via LLM_BASE_URL. Everything else is optional.

​
Next steps

Deployment

Docker, systemd, VPS, and local setup

Interfaces

Telegram, Web API, and CLI usage

Architecture

How the pieces fit together

Security

What EchOS does with your data