Что такое MiroFish?
MiroFish — инструмент с открытым исходным кодом, который создаёт ИИ-агентов из реальных документов (новостей, отчётов, публикаций), запускает между ними диалог и формирует аналитический отчёт о том, как разные «персонажи» реагируют на событие.
Если кратко: вы даёте инструменту текст → он «оживляет» участников ситуации → они общаются между собой → вы получаете прогноз реакций и итоговый анализ.
🔥 Почему о MiroFish все говорят?
Проект получил инвестиционный раунд в $4 млн и вырос из исследовательской работы по системам типа BettaFish — многоагентным симуляциям, моделирующим поведение общества. После публикации кода инструмент мгновенно разошёлся по сообществам разработчиков и аналитиков.
Текущая версия — 0.1.0, лицензия — AGPL-3.0.
🧠 Как это работает под капотом?
Весь процесс — пять этапов, которые система проходит автоматически:
- Загрузка документа. Новость, PDF-отчёт, пресс-релиз или любой текст.
- Извлечение сущностей. LLM выделяет персонажей, компании и события из текста.
- Создание ИИ-личностей. Каждая сущность получает характер, цели и историю — на базе Zep Cloud.
- Симуляция диалогов. Агенты взаимодействуют, спорят и принимают решения.
- Аналитический отчёт. Система обобщает результаты: кто как отреагировал и что вероятнее всего произойдёт.
🚀 Быстрый старт: запускаем MiroFish локально
Шаг 1: подготовка среды
Перед установкой убедитесь, что у вас есть:
- Docker — для изоляции окружения
- Node.js 18+ — для фронтенда
- Python 3.10+ — для бэкенда симуляции
git clone https://github.com/mirofish/mirofish
cd mirofish
docker compose up --buildШаг 2: ключи API (LLM и Zep Cloud)
Как не потратить все деньги на старте? Начните с модели gpt-4o-mini вместо gpt-4o — она в 15 раз дешевле и подходит для тестовых симуляций. Для Zep Cloud используйте бесплатный тир: он покрывает до 1000 агентных взаимодействий в месяц.Создайте файл .env в корне проекта:
OPENAI_API_KEY=sk-...
ZEP_API_KEY=z_...Шаг 3: первый запуск
После запуска контейнеров откройте браузер на localhost:3000, вставьте любую новость и нажмите «Simulate». Первый результат появится через 1–3 минуты.
💰 Калькулятор стоимости: во сколько обойдётся одна симуляция?
Стоимость зависит от выбора модели и числа агентов. Ориентировочные цены:
| Конфигурация | Агентов | Цена / симуляция |
|---|---|---|
| gpt-4o-mini · 5 агентов | 5 | ~$0.02 |
| gpt-4o · 5 агентов | 5 | ~$0.30 |
| gpt-4o · 20 агентов | 20 | ~$1.20 |
| gpt-4o · 50 агентов | 50 | ~$3.00+ |
Zep Cloud: бесплатный тир покрывает тестовое использование. При продуктивной нагрузке — от $25/мес. Рекомендуем заранее установить расходный лимит в OpenAI Dashboard.
📊 Примеры использования: не только биржа и политика
Кейс 1: анализ литературного произведения
Загрузите первые главы романа — MiroFish создаст агентов из персонажей и смоделирует их взаимодействие. Это помогает предсказать развитие сюжета и проверить, насколько характеры авторски убедительны. Полезно редакторам и литературным критикам.
Кейс 2: PR-менеджер тестирует пресс-релиз
Прогоните черновик релиза через симуляцию с агентами-журналистами, скептичным инвестором и лояльным клиентом. Вы увидите «острые» вопросы до публикации и сможете доработать текст.
Кейс 3: трейдер оценивает реакцию на новость ФРС
Загрузите протокол заседания ФРС. MiroFish создаёт агентов-трейдеров с разными стратегиями и запускает их реакцию. Отчёт показывает, как может сдвинуться рыночный консенсус.
⚠️ Подводные камни и честные ограничения (версия 0.1.0)
- Windows — с оговорками. Docker Desktop на Windows иногда даёт ошибки с volume mount. Рекомендуемая платформа — macOS или Linux.
- API-косты могут удивить. 50+ агентов с gpt-4o — это реальные деньги. Установите лимит в OpenAI Dashboard перед экспериментами.
- Галлюцинации агентов. Агенты могут генерировать «факты», которых нет в исходном документе. Результаты — вспомогательный инструмент, не истина в последней инстанции.
- Длинные документы тормозят. Документы более 50 000 токенов обрабатываются медленно. Оптимально — разбивать на смысловые части.
❓ FAQ: часто задаваемые вопросы о MiroFish
Чем MiroFish отличается от ChatGPT?
ChatGPT — это один ИИ-собеседник. MiroFish создаёт множество независимых агентов с разными характерами и целями, которые взаимодействуют между собой. Результат — симуляция социальной динамики, а не один связный ответ.
Зачем нужен Zep Cloud?
Zep Cloud — это долговременная память для агентов. Без него агент «забывает» всё после каждого сообщения. Zep позволяет агентам помнить историю взаимодействий и накапливать контекст на протяжении всей симуляции.
Можно ли использовать русский язык в симуляции?
Да — при использовании gpt-4o или claude-3. Русскоязычные документы обрабатываются корректно, агенты отвечают на русском. Системные промпты MiroFish пока написаны на английском, что иногда может влиять на стиль ответов.
🔗 Ссылки и что делать дальше
Лицензия: AGPL-3.0. Для коммерческого использования в закрытых продуктах уточняйте условия у команды проекта.