# EchOS

## Docs

- [Architecture](https://docs.echos.sh/architecture.md): Data flow, package layout, storage, and search internals.
- [Search Quality Benchmarks](https://docs.echos.sh/benchmarks.md): How EchOS search pipeline stages affect retrieval quality — methodology, results, and how to reproduce.
- [Categorization](https://docs.echos.sh/categorization.md): How EchOS categorises and tags knowledge automatically.
- [Deployment](https://docs.echos.sh/deployment.md): Deploy EchOS via Docker, systemd on a VPS, or locally.
- [Installation](https://docs.echos.sh/distribution.md): How to install and update EchOS — one-liner, Homebrew, Docker, or manual setup.
- [Images](https://docs.echos.sh/images.md): Image storage, description, and visual search.
- [Interfaces](https://docs.echos.sh/interfaces.md): Configure and use Telegram, Web API, CLI, and MCP Server interfaces.
- [Introduction](https://docs.echos.sh/introduction.md): EchOS — your personal AI knowledge system, self-hosted and agent-driven.
- [Knowledge Import](https://docs.echos.sh/knowledge-import.md): Import Obsidian vaults, Notion exports, plain markdown files, PDFs, audio, and RSS feeds.
- [MCP Server](https://docs.echos.sh/mcp-server.md): Connect EchOS to Claude Code, Cursor, Windsurf, and any other MCP-compatible AI client.
- [Oracle Cloud Vault](https://docs.echos.sh/oracle-cloud-vault.md): Secrets management with Oracle Cloud Vault.
- [Building a Plugin](https://docs.echos.sh/plugins.md): Extend EchOS with custom content processors and agent tools.
- [Releasing](https://docs.echos.sh/releasing.md): How to cut a release and what CI does automatically.
- [Remote Access](https://docs.echos.sh/remote-access.md): Access your knowledge files from a local machine.
- [Scheduler](https://docs.echos.sh/scheduler.md): Background jobs, digests, reminders, and cron configuration.
- [Security](https://docs.echos.sh/security.md): Security model, guarantees, auth, SSRF prevention, and rate limiting.
- [Slash Commands](https://docs.echos.sh/slash-commands.md): Built-in slash commands available in Telegram and CLI.
- [Tools Reference](https://docs.echos.sh/tools.md): Everything EchOS can do — a plain-language guide to every tool available to the agent.
- [Troubleshooting](https://docs.echos.sh/troubleshooting.md): Common setup, runtime, and development issues with solutions.
- [Writing & Voice](https://docs.echos.sh/writing.md): Shape how EchOS talks and writes on your behalf.

## OpenAPI Specs

- [openapi](https://docs.echos.sh/api-reference/openapi.json)