# Документация Iva

Iva - self-hosted ассистент в Telegram со слоями памяти: всё, что вы ему шлёте, превращается в vault, который открывается в Obsidian.

**На русском:**

- [use-cases.md](use-cases.md) - кто и зачем ставит Иву: сценарии для бизнеса, работы и жизни
- [install.md](install.md) - одна команда на чистом VPS, от curl до первого сообщения бота
- [configuration.md](configuration.md) - все переменные `.env` и мастер настройки
- [memory.md](memory.md) - как копится память: транскрипты, выжимки, карточки, поиск
- [security.md](security.md) - инъекции ловятся на входе, секреты вычищаются на выходе, чужим бот молчит
- [reminders.md](reminders.md) - как попросить Иву напомнить: разовое и повторяющееся, минутный диспетчер, что бывает при сбое доставки
- [schedules.md](schedules.md) - что запускается само, какой факт остаётся после каждого запуска, как агент просыпается с ним и что будет, если он не проснётся
- [plugins.md](plugins.md) - плагины: что это, как поставить, как написать свой и чем вы рискуете
- [trace.md](trace.md) - журнал хода: что ядро пишет на каждый ход, как собрать один ход, хранение и тумблер содержимого
- [faq.md](faq.md) - короткие ответы про цену, модели, приватность и Obsidian
- [CONTEXT.md](../../CONTEXT.md) - глоссарий: одно понятие - одно слово и слова, которых в проекте нет
- [philosophy.md](../philosophy.md) - скилл важнее кода, тонкий harness, принцип колеса
- [adr/](../adr/) - решения, которые связывают код: что выбрали, почему и что отвергли

**Пока только по-английски:**

- [providers.md](../providers.md) - все внешние сервисы, с реальными ценами
- [deploy.md](../deploy.md) - systemd-сервисы и таймеры, long polling, обновления, бэкапы
- [cli.md](../cli.md) - слэш-команды в Telegram и CLI `iva`
- [menu.md](../menu.md) - центр настроек `/menu`: карта экранов, что применяется сразу, а что после рестарта, приём ключей, тест характера, интервью памяти
- [extending.md](../extending.md) - скиллы, MCP-подключения, свои инструменты
- [troubleshooting.md](../troubleshooting.md) - бот молчит, таймеры падают, провайдер ошибается
- [tech-debt.md](../tech-debt.md) - известные пробелы и отложенные решения, открытым списком

Русская версия главного README - [README.ru.md](../../README.ru.md).