Iva CLI
Самохостящийся ИИ-ассистент в Telegram с памятью в Markdown: голос, фото, задачи и Google Workspace на вашем сервере.
- 287 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Инструмент оболочки работает с правами пользователя, установившего Iva, а установщик запускается через `curl | bash`.
- Доступ к Gmail, Календарю, Диску и личному аккаунту Telegram (`userbot`) широкий; `userbot` нарушает правила Telegram и может привести к блокировке.
- Сообщения, транскрипты и фото уходят провайдерам модели и распознавания.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/ivaОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Инструмент оболочки работает с правами пользователя, установившего Iva, а установщик запускается через `curl | bash`.
- Доступ к Gmail, Календарю, Диску и личному аккаунту Telegram (`userbot`) широкий; `userbot` нарушает правила Telegram и может привести к блокировке.
- Сообщения, транскрипты и фото уходят провайдерам модели и распознавания.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Iva принимает сообщения в Telegram и раскладывает их в Obsidian-совместимое хранилище. Голосовые заметки, фото, пересланные посты и решения превращаются в Markdown-карточки: контакты, проекты, решения, идеи. Каждое сообщение дословно попадает в дневной журнал, а ночная сводка раз в сутки складывает день в неделю, месяц и год. Ассистент ищет по памяти и в вебе, ведет задачи и напоминания, работает с Gmail, Календарем, Диском, Таблицами и Документами через CLI `gws`. Скиллы и MCP-серверы добавляются одним файлом. Все работает на вашем сервере с вашими ключами.
Для кого. Предпринимателям и специалистам, которым нужен личный ассистент в мессенджере с долгой памятью, развернутый у себя, а не у стороннего сервиса.
Подходит, если
- Через месяцы приходится вспоминать, что договорились с клиентом о последней поставке.
- Пятиминутная голосовая заметка из машины должна стать списком задач или черновиком письма.
- Нужен ассистент, у которого данные и ключи остаются на вашем сервере.
- Из чата требуется создать документ в Google Docs или встречу в Календаре.
Не подходит, если
- Нет сервера на Ubuntu или Debian и желания возиться с установкой: Iva ставится на свой хост.
- Модель и распознавание речи должны остаться без облака: они работают через внешние API.
- Рабочие процессы запрещают автоматизировать личный аккаунт Telegram: режим `userbot` нарушает условия сервиса.
Пример запроса к агенту
Запомни: Марина из Acme ждет исправленную смету к пятнице и не берет трубку. Потом спроси, как лучше напомнить ей о смете.Ограничения
Установщик рассчитан на Ubuntu или Debian и Node.js 24 и запускается от обычного пользователя, не от `root`. Модель и распознавание речи работают через облачные API, которые вы выбираете и оплачиваете (OpenRouter, Ollama Cloud, OpenCode Go, подписки ChatGPT и Claude). Режим `userbot` нарушает правила Telegram и может привести к ограничению аккаунта, поэтому его включают по желанию. Защита от внедрения инструкций закрывает не все источники: тексты документов и вывод `agent-browser` не проверяются.
Как отключить. Остановите службы Iva через `systemd`, отзовите токен бота в @BotFather и ключи провайдеров. Хранилище памяти лежит в вашем приватном git-репозитории, его удаляют отдельно.
Частые вопросы
Где хранится память?
В Markdown-файлах: дневные журналы `daily/`, сводки `summaries/` и карточки `cards/`, плюс файл `CORE.md` до 3600 знаков, который идет в каждый запрос. Это ваш приватный git-репозиторий.
Нужен ли публичный адрес?
Нет. Мост опрашивает Telegram сам, домен, HTTPS и вебхук не требуются.
Какие модели можно подключить?
Шесть вариантов: OpenCode Go, Ollama Cloud, OpenRouter, подписка ChatGPT, подписка Claude Pro или Max и свой OpenAI-совместимый адрес.
Как обновляться?
`iva update` ставит только релизные версии. `iva beta` включает ветку `beta`, `iva stable` возвращает стабильный канал.
Как работает голос?
Голосовые, аудио и видеозаметки расшифровывает Deepgram `nova-3`, язык (русский, узбекский или английский) определяется автоматически.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыХранилище Obsidian со скиллами для рабочих встреч: транскрипты из Gmail, участники, задачи и недельные итоги.
Сборочный скрипт и шаблоны, которые превращают хранилище Obsidian в рабочую память ИИ: заметки в markdown, без векторной базы
Шаблон vault в Obsidian с хуками, командами и скиллами, который дает Claude Code, Codex и Gemini CLI постоянную память между сессиями
Compass, шаблон хранилища Obsidian, берет вопросы дневника и привычки из общего файла настроек для всех связанных панелей.
Obsidian и Claude Code PKM
Obsidian + Claude Code PKM
Шаблон хранилища Obsidian для Claude Code: команды /daily, /weekly, /monthly и /project связывают цели на три года с задачами на сегодня
Claudia превращает Claude Code или Codex в помощника, который хранит людей и обещания в SQLite и вики Obsidian.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Iva (эта карточка) | нет | 287 | |
| OpenClaw | нет | 393 956 | открытый личный ассистент для нескольких мессенджеров; Iva сосредоточена на Telegram и держит память в Markdown-хранилище с ночной сверткой |
| GolemBot | нет | 322 | подключает кодовых агентов к Telegram, Slack и Discord; Iva сама служит ассистентом с памятью, задачами и Google Workspace |
Коротко о README
Установщик ставит две пользовательские службы `systemd`, два сторожевых таймера и семь расписаний. Документация на русском лежит в `docs/ru/`.