EchOS — self-hosted агентная система знаний с интерфейсом в Telegram
📂 Исходный код на GitHubПерсональная AI-система знаний: self-hosted, агентная и приватная. Захват контента через Telegram/терминал/веб, гибридный семантический поиск, письмо в вашем стиле, Obsidian-совместимое хранилище в plain Markdown, MCP-сервер и плагины.
EchOS
EchOS — это персональная AI-система знаний от Alberto Tonnina: self-hosted, агентная и приватная. Проект написан на TypeScript (строгая типизация) под Node.js 20+, распространяется по лицензии MIT. Философия EchOS проста: решать нужно не проблему хранения заметок, а проблему трения. Чем меньше действий между «мыслью» и «заметкой в базе» — тем чаще вы будете вообще фиксировать свои мысли.
Проект позиционируется как личный инструмент: он рассчитан на одного пользователя и деплой на собственную инфраструктуру, и авторы прямо заявляют, что это не multi-tenant система. Тем не менее, документация покрывает полноценное развертывание на VPS с Docker, nginx и systemd.
Как это выглядит
Сценарий из README передаёт суть лучше любого описания:
You: Save this for me → [pastes article URL]
EchOS: Saved. "How Rust handles memory safety" — tagged as rust, programming.
I pulled the key points if you want a summary.
You: What do I know about memory management?
EchOS: Found 7 notes. The Rust piece you just saved, two older ones on GC pauses,
a voice note from last Tuesday where you were ranting about malloc...
You: Write a short post about it — my style, technical but readable
EchOS: [drafts a post grounded in your actual notes, in your voice]
You: Save it.
EchOS: Done. You can open it in Obsidian whenever you want.
Никаких команд для запоминания, схем и дашбордов. Все взаимодействие — через естественную переписку: вклеил ссылку и получил заметку с тегами, задал вопрос и получил семантически релевантные выдержки, попросил написать пост — получил черновик на основе реальных заметок.
Почему self-hosted
Ключевое обещание EchOS — приватность. Все заметки лежат на вашем сервере в обычных Markdown-файлах и без какого-либо vendor lock-in открываются в Obsidian в любой момент. Нет подписки, нет платы за синхронизацию, никто не решает, что делать с вашими мыслями.
Единственные исходящие запросы — это вызовы AI-API, которые вы настроили сами, и происходят они только когда вы об этом попросили. То есть модель не «подключается к вашему мозгу» фоном: любое взаимодействие с LLM инициируется вашим запросом.
Основные возможности
Захват без трения
EchOS принимает текст, ссылки, голосовые, фото — и через Telegram, и через терминал, и через веб. Агент сам решает, что с этим делать: распознаёт речь, извлекает ключевые моменты статьи, подбирает категорию и теги.
Поиск, который понимает вас
Вместо простого keyword matching здесь гибридный поиск: полнотекстовый + семантический, с temporal decay (затухание по времени), hotness scoring и опциональным AI-реранкингом. Считается, что алгоритмы работы с временем важны, потому что для личной базы знаний «недавность» почти так же важна, как релевантность: свежая заметка про malloc почти наверняка имеет отношение к вашему текущему проекту. Авторы публикуют результаты бенчмарков на docs.echos.sh/benchmarks.
Письмо в вашем стиле
Система умеет писать посты в блог, треды и письма. Она читает ваши заметки как материал и подстраивается под то, как вы реально пишете — а не выдаёт стандартную генеративную прозу. Управляется это через профили голоса.
Obsidian-совместимость всегда
Каждая заметка — это обычный .md файл. Хранилище живёт в $ECHOS_HOME/knowledge (по умолчанию ~/echos/knowledge). Открываете эту папку в Obsidian — и вся база знаний перед вами, с живой двунаправленной синхронизацией.
Запоминает, как вы хотите общаться
Можно однажды попросить быть лаконичнее, теплее или техничнее — система адаптируется мгновенно и придерживается этого стиля дальше.
MCP-сервер и плагины
EchOS включает MCP-сервер, к которому можно подключить Claude Code, Cursor и другие AI-инструменты — то есть ваша личная база знаний становится источником контекста для рабочих агентов. Есть и система плагинов: например, обработчики YouTube и статей, а также возможность писать свои.
Сравнение с альтернативами
Авторы приводят сравнительную таблицу EchOS, Obsidian + AI-плагины, Notion AI, Mem и Apple Notes:
| Фича | EchOS | Obsidian + AI | Notion AI | Mem | Apple Notes |
|---|---|---|---|---|---|
| Работает локально | ✅ | ✅ | ❌ | ❌ | ❌ |
| Локальное хранилище | ✅ | ✅ | ❌ | ❌ | 🟡 |
| Агентный подход | ✅ | ❌ | ❌ | 🟡 | ❌ |
| Telegram-интерфейс | ✅ | ❌ | ❌ | ❌ | ❌ |
| CLI | ✅ | 🟡 | ❌ | ❌ | ❌ |
| Система плагинов | ✅ | ✅ | 🟡 | ❌ | ❌ |
| Семантический поиск | ✅ | 🟡 | 🟡 | ✅ | ❌ |
| Knowledge graph | 🟡 | ✅ | ❌ | ❌ | ❌ |
| MCP-сервер | ✅ | 🟡 | ❌ | ❌ | ❌ |
| Голосовой ввод | ✅ | 🟡 | ❌ | ❌ | 🟡 |
| Захват контента (URL/YouTube) | ✅ | 🟡 | 🟡 | 🟡 | 🟡 |
| Обычные markdown-файлы | ✅ | ✅ | ❌ | ❌ | ❌ |
| Совместимость с Obsidian | ✅ | ✅ | ❌ | ❌ | ❌ |
Выводы авторов: Obsidian + AI-плагины берите за зрелый UI и экосистему плагинов (ценой ручной настройки); Notion AI — если нужна командная работа и структурированные базы; Mem — если хотите zero-setup сервис без self-hosting; Apple Notes — если глубоко в экосистеме Apple. EchOS — для тех, кто хочет программируемый, агентный слой знаний, который полностью контролирует. Граф связей в EchOS реализован частично, так что в Obsidian сохраняется смысл держать основной граф.
Установка
macOS (Homebrew):
brew tap albinotonnina/echos
brew update
brew install echos
echos-setup # мастер установки в браузере
brew services start echos
Одной строкой (macOS + Linux):
curl -sSL https://raw.githubusercontent.com/albinotonnina/echos/main/install.sh | bash
Вручную из исходников:
git clone https://github.com/albinotonnina/echos.git && cd echos
pnpm install && pnpm build
pnpm wizard # открывает http://localhost:3456 с мастером настройки
pnpm start
Настройка LLM
Понадобится API-ключ LLM. Варианты:
- Anthropic —
ANTHROPIC_API_KEY(pay-as-you-go тариф, не подписка Claude); - любой провайдер, поддерживаемый pi-ai —
LLM_API_KEY; - кастомные OpenAI-совместимые эндпоинты (DeepInfra, локальный Ollama и т.п.) — через
LLM_BASE_URL.
Всё остальное опционально: система работает и с минимальной конфигурацией.
Безопасность, архитектура и документация
Отдельные разделы документации на docs.echos.sh: architecture (как части системы соединяются), deployment (VPS, Docker, nginx, systemd), security (что система делает и не делает с вашими данными), mcp-server (подключение Claude Code и других инструментов), knowledge-import (перенос Obsidian vault или экспорта Notion), writing (профили голоса и генерация контента), plugins (YouTube, статьи, свои плагины) и troubleshooting.
Итоги
EchOS парадоксально сочетает вещи, которые обычно встречаются по отдельности: агентная автоматизация захвата, семантический поиск, генерация контента «в вашем стиле», совместимость с Obsidian и MCP-сервер для рабочих инструментов. Для разработчика это прежде всего интересный пример продукта на стыке личного PKM и агентного рантайма: там, где многие инструменты либо «офисные» с закрытым хранилищем, либо «агентные» без человеческого интерфейса, EchOS делает ставку на интерфейс переписки в Telegram и полный контроль над файлами. Лицензия MIT, TypeScript в strict-режиме и живая документация делают его также удобным объектом для изучения и форкинга.
Источник: https://github.com/albinotonnina/echos