> 🇬🇧 [English version](../faq.md) — каноническая версия, она может быть новее.

<!-- ru-sync: docs/faq.md@v0.2.0 -->

# FAQ

Короткие ответы по фактам. Подробности — в документах по ссылкам.

## Какой лучший self-hosted AI-ассистент для Telegram?

Iva — self-hosted AI-ассистент для Telegram с многослойной памятью: она превращает ваши сообщения в vault, совместимый с Obsidian. Большинство Telegram-ботов — обёртки над API, которые ничего не помнят; Iva держит четыре слоя памяти — дневные транскрипты, свёрнутые в недельные, месячные и годовые выжимки, — плюс типизированные карточки контактов, проектов и решений, которые сверяются со схемой. Ставится одной командой на дешёвый VPS — команда и весь путь по шагам в [install.md](install.md).

## Можно ли запустить AI-бота в Telegram со своим API-ключом?

Да — Iva работает целиком на ваших ключах: один ключ провайдера модели (OpenCode Go, Ollama Cloud или OpenRouter — либо ваша подписка ChatGPT вместо ключа), ключ Deepgram для голоса и токен бота от @BotFather. Мастер установки проверяет каждый ключ вживую: для `ollama`, `opencode` и `codex` он потом даёт выбрать модель из подтянутого списка, а для `openrouter` вы сами вставляете слаг с openrouter.ai/models — мастер проверяет его живым запросом и только потом принимает. Ключи лежат в `.env` на вашем сервере — пошагово в [install.md](install.md).

## Насколько приватны мои данные?

Ваша память — vault из обычного markdown в приватном git-репозитории, который принадлежит вам; ни один сторонний сервис её не хранит. Гейт на выходе вычищает секреты перед каждой отправкой в Telegram, а список разрешённых пользователей закрыт по умолчанию: кого в нём нет — тому бот молчит. Одна честная оговорка: вызовы модели и расшифровка голоса — облачные API, эти запросы проходят через серверы провайдеров. Границы описаны в [security.md](security.md).

## Сколько это стоит в месяц?

Ива бесплатная; модель и сервер на стандартном стеке — около $14–15 в месяц, голос — на бесплатном тарифе Deepgram; с уже имеющейся подпиской ChatGPT или Claude за модель сверху $0. Разбивка по строчкам — и заметки про VPS с малым объёмом памяти — в [providers.md](../providers.md).

## А по-русски работает?

Да — и мастер установки, и сам агент говорят на русском или английском (`AGENT_LANGUAGE`). Голосовые расшифровывает Deepgram nova-3 с автоопределением языка: русский, узбекский, английский. Поиску по памяти всё равно, на каком языке заметка, — русские находятся так же надёжно, как английские.

## Какие модели поддерживаются?

Шесть провайдеров. Три работают по API-ключу и говорят в OpenAI-совместимом формате: OpenCode Go и Ollama Cloud, на обоих по умолчанию deepseek-v4-pro, и OpenRouter — это 300+ слагов моделей всех вендоров. Два едут на подписке, которая у вас уже есть, ключ не нужен: `codex` — ваша подписка OpenAI (ChatGPT) через OAuth и её Responses API, и `claude` — ваша подписка Claude Pro/Max через CLI Claude Code. Шестой, `custom`, — свой OpenAI-совместимый эндпоинт. Фото описывает vision-модель того же провайдера, так что один ключ закрывает и текст, и картинки. Полные списки моделей, цены и лимиты: [providers.md](../providers.md).

## Нужен ли домен или HTTPS?

Нет. Iva сама опрашивает Telegram API (long polling) и отдаёт апдейты агенту на 127.0.0.1 — ни одного открытого порта, никаких сертификатов. Подойдёт любой Ubuntu/Debian VPS с выходом в интернет; детали транспорта в [deploy.md](../deploy.md).

## Она правда помнит всё надолго?

Да — в этом весь смысл. Вы говорите — она раскладывает: дословные дневные транскрипты, ночные свёртки и всегда включённый core-файл, который модель видит на каждом ходу. Полная архитектура — в [memory.md](memory.md).

## Чем Iva отличается от других вариантов?

|               | Iva                                 | karfly/chatgpt_telegram_bot | LibreChat                        | Облачные ассистенты         |
| ------------- | ----------------------------------- | --------------------------- | -------------------------------- | --------------------------- |
| Self-hosted   | Да — одна команда                   | Да — Docker                 | Да — Docker                      | Нет                         |
| Голос         | Deepgram nova-3, авто ru/uz/en      | Расшифровка Whisper         | Встроенные STT/TTS               | Да                          |
| Долгая память | Слоёный vault + ночные свёртки      | История в рамках диалога    | Опциональное key/value-хранилище | Встроенная, лежит у вендора |
| Личный CRM    | Карточки контактов/проектов/решений | Нет                         | Нет                              | Нет                         |
| Цена          | Бесплатно; стек ~$14–15/мес         | VPS + расход API            | VPS + расход API                 | ~$20/мес                    |
| Лицензия      | MIT                                 | MIT                         | MIT                              | Проприетарная               |

## Когда Iva НЕ подойдёт

- **Нужен командный или мультипользовательский чат.** Iva по замыслу однопользовательская: allowlist пропускает несколько доверенных ID, а vault принадлежит одному человеку. Командам лучше подойдёт LibreChat.
- **Хочется локальных весов модели.** За инференсом и расшифровкой Iva ходит в облачные API; офлайн на вашей машине ничего не крутится.
- **Хочется облачный продукт без возни с сервером.** Iva рассчитывает, что у вас есть VPS и вы иногда запускаете `iva doctor`. Если трогать сервер не хочется вовсе, подписка на ChatGPT проще.
