smixs/iva-agent

Что это?

Ключевые возможности

• 01Транскрибирует голосовые заметки с помощью Deepgram и описывает фотографии, используя возможности vision-модели.
• 02Дословно сохраняет сообщения за каждый день в Markdown и объединяет их в недельные, месячные и годовые сводки.
• 03Хранит файл CORE.md, который добавляется в каждый промпт и обеспечивает постоянный контекст.
• 04Ищет по памяти с помощью BM25 и переранжирования по графу связей; доступен и векторный поиск.
• 05Управляет задачами и напоминаниями, а также формирует ежедневную сводку.
• 06Подключается к Gmail, Calendar, Drive, Sheets, Docs и Tasks через CLI gws, а также поддерживает MCP-серверы и навыки.

Сценарии использования

• Вспоминать, о чём договорились с клиентом несколько месяцев назад.
• Превращать длинную голосовую заметку в список задач, черновик письма или карточку встречи.
• Вести личную CRM контактов и последующих действий прямо в Telegram.
• Запустить персонального ассистента на собственном сервере, чтобы данные оставались у вас.

Быстрый старт

1. 1

   Получите токен бота у BotFather

2. 2

   Клонируйте репозиторий

   git clone https://github.com/smixs/iva-agent.git ~/iva
3. 3

   Запустите установщик из клонированного репозитория и ответьте на его вопросы

   cd ~/iva && bash install.sh
4. 4

   Напишите своему боту, чтобы мастер завершил настройку

Что важно знать

• !Требуются Node.js версии 24 или выше и сервер, который вы будете обслуживать самостоятельно, поэтому потребуется приложить усилия для самостоятельного хостинга.
• !Необходимы API-ключ или подписка у провайдера моделей. Запросы к модели и для транскрибации отправляются в облачные API, использование которых оплачиваете вы.
• !Дополнительная функция userbot нарушает условия использования Telegram и может привести к ограничению или блокировке аккаунта.

Темы

Частые вопросы

Что такое iva-agent?

Самостоятельно размещаемый AI-ассистент в Telegram, который сохраняет голосовые заметки, фото и сообщения в markdown-хранилище и позволяет искать их позже. Iva — AI-ассистент для Telegram, который работает на вашем сервере. Сообщения, голосовые заметки, фотографии, PDF-файлы и пересланные публикации сохраняются в виде датированных файлов в формате Markdown в хранилище, совместимом с Obsidian. Со временем из них формируются структурированные карточки контактов, проектов, решений и заметок.

iva-agent можно использовать бесплатно? Какая у него лицензия?

iva-agent распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.

iva-agent всё ещё поддерживается?

Активно поддерживается. Последний коммит в iva-agent — 22 окт. 2026 г..

Для чего можно использовать iva-agent?

Вспоминать, о чём договорились с клиентом несколько месяцев назад. Превращать длинную голосовую заметку в список задач, черновик письма или карточку встречи. Вести личную CRM контактов и последующих действий прямо в Telegram. Запустить персонального ассистента на собственном сервере, чтобы данные оставались у вас.

Как установить iva-agent?

Получите токен бота у BotFather Клонируйте репозиторий: git clone https://github.com/smixs/iva-agent.git ~/iva Запустите установщик из клонированного репозитория и ответьте на его вопросы: cd ~/iva && bash install.sh Напишите своему боту, чтобы мастер завершил настройку

Где скачать iva-agent?

Исходный код и инструкции по установке — на GitHub: https://github.com/smixs/iva-agent