NeuroMita 0.1 Alpha

🌐 Русский · English

NeuroMita — фанатский мод-проект, в котором можно общаться с Митами, управляемыми языковыми моделями, и видеть их реакции в Unity-сцене. Текущая версия — самостоятельный Unity-билд: для запуска не нужна установленная MiSide, в релизе есть всё необходимое.

[!IMPORTANT] NeuroMita находится в Alpha: интерфейс, механики и форматы данных могут меняться. Перед крупным обновлением полезно сохранить папки Settings и Histories.

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

[!TIP] Для начала настройте только один LLM-провайдер. Озвучку, локальные модели, RAG и другие дополнительные возможности можно подключить позже.

Установка и обновление

На первом запуске NeuroMita самостоятельно проверит и развернёт основные Python-зависимости. Не закрывайте окно до завершения этого этапа.

На главной странице установите Unity-часть, если интерфейс предлагает это сделать, затем нажмите Играть.

После запуска Unity оставьте лаунчер NeuroMita открытым: он поддерживает связь между игрой и ИИ. Окно можно свернуть.

Если не удалось устранить проблемы с сетью при загрузке Unity, есть ручной способ установки.

Обновления устанавливаются на главной странице: отметьте нужные компоненты и нажмите Обновить. Не распаковывайте новый ZIP поверх уже работающей папки NeuroMita.

Настройка первого диалога

1. Откройте Настройки → API пресеты.
2. Нажмите + или строку «Нажмите, чтобы создать пресет».
3. Выберите шаблон провайдера, вставьте API key и укажите модель.
4. Сохраните пресет и сделайте его активным.
5. Откройте Настройки → Персонажи, выберите персонажа и набор промптов.
6. Вернитесь в чат / Sandbox и отправьте первое сообщение.

Для начала выберите один вариант, а не настраивайте их по очереди. Самый простой первый выбор — OpenRouter; Google AI Studio, Mistral и LM Studio — альтернативы. Подробные действия, включая варианты для России: docs/MODELS.md.

Пользователям из России для доступа к некоторым зарубежным AI-сервисам может потребоваться VPN. Доступность зависит от провайдера и региона.

Если ответ не приходит, сначала проверьте активный пресет, название модели и баланс/лимиты у провайдера, затем откройте устранение неполадок.

Что умеет NeuroMita

• Общаться с Митами через языковые модели (LLM — нейросети, которые генерируют текстовые ответы).
• Использовать историю, память, RAG и граф знаний, чтобы учитывать прошлые разговоры.
• Связывать ответы с действиями и состоянием персонажа в Unity-сцене.
• Работать с озвучкой ответов и голосовым вводом; локальные модели управляются из AI Hub.
• При необходимости использовать изображения, экран или камеру как дополнительный контекст.
• Хранить API-пресеты, модели, параметры диалога и промпты в настройках приложения.

Часть возможностей требует отдельных загрузок или мощного оборудования. Начните с обычного текстового диалога — для него достаточно подключить один LLM-провайдер.

Системные требования

Конкретные требования локальной озвучки зависят от выбранной модели — см. гайд по локальной озвучке.

[!NOTE] Не устанавливайте Python, .NET или MelonLoader отдельно: в актуальном релизе встроенный Python и основной runtime поставляются вместе с приложением.

Дополнительные возможности

Озвучка и распознавание речи

В Настройки → Голос включается озвучка, а в Настройки → Микрофон выбирается устройство и распознавание речи. Локальные модели озвучки, ASR и связанные зависимости ставятся через AI Hub. Для локальной озвучки используйте пошаговый гайд.

Изображения, экран и камера

При необходимости NeuroMita может использовать изображение, содержимое экрана или камеру как дополнительный контекст для ответа. Доступность зависит от выбранной модели и её настроек.

AI Hub

AI Hub — встроенный раздел для установки и обновления локальных компонентов: моделей озвучки, ASR и связанных зависимостей. Обычный текстовый диалог можно начать без локальных компонентов.

Память диалога

NeuroMita сохраняет историю и может удерживать важный контекст в долгом разговоре. Когда диалог становится слишком длинным для контекста модели, система в фоне сжимает старую часть в краткую сводку, оставляя свежие сообщения доступными для общения.

RAG помогает дополнительно находить релевантные фрагменты истории и воспоминаний, а граф знаний — связывать сущности и отношения. Это необязательная тонкая настройка: обычному диалогу достаточно стандартной памяти. Подробности: RAG Guide.

Где искать помощь

• Посмотрите TROUBLESHOOTING.md: там собраны симптомы, частые HTTP-ошибки и проверка локальных компонентов.
• Откройте раздел Логи в приложении или файл NeuroMitaLogs.log в папке NeuroMita.
• Если проблема не решена, обратитесь в Discord. Приложите версию NeuroMita, провайдера и модель, шаги воспроизведения, скриншот и релевантный фрагмент лога. Никогда не публикуйте API keys.

Стать частью разработки

NeuroMita развивается силами сообщества. Сейчас особенно нужны:

• Unity-разработчики — C#, игровые механики, интеграция и интерактивные сцены.
• Unity level-дизайнеры — наполнение игры на основе готовых механик: сборка сцен, расстановка объектов, свет, триггеры и атмосфера.
• Python-разработчики — помощь с отдельными задачами backend, AI-интеграций и стабильности.

Также будем рады 3D-моделерам и аниматорам. Задачи для них появляются точечно — для конкретных сцен, персонажей, предметов или реакций. Если хотите помочь, напишите VinerX в Discord.

Команда и благодарности

Текущая команда

• VinerX — автор проекта.
• Atm4x (_atm4x) — ведущий разработчик и главный архитектор новой версии мода.
• mactep_kot_ — точечные правки в Python и Unity, промптинг и тестирование.

---

Участники предыдущих этапов

⠀

• ejichek — большой вклад в Unity-билд, включая экран смерти.
• vlad2830 — C#-часть MelonLoader-мода и Python-часть.
• Nelxi (distrane25) — внедрение голосового ввода на Python.
• Feanor (feanorqq) — настройка домика Доброй Миты.

---

Анимации и персонажи

⠀

• JPAV — настройка префабов Мит.
• MaxDel (max.del) — анимации Миты.
• Alex Sh. (alexxdream) — анимации Миты.

---

Промптеры

⠀

• Feanor (feanorqq) и Tkost — промпты Доброй Миты.
• Josefumo (josefummi) — Коротковолосая Мита.
• Gad (gad991) — Кепочка.
• ! Depikoov (depikoov) — Мила, Сонная Мита.
• DemoNicanT (demonicant) — Призрачная Мита.

---

Тестировщики

⠀

• Nazarlo (nazarlo)
• SuperAngel (superangel25)
• #1 crazy Mita hater (valtiata)
• Unaligneds (fiery_crotch_669)

---

Особая благодарность

⠀

• Sutherex — показал OpenRouter, помогает организационно и с темой нейросетей, а также сделал логотип.
• Доктор Диванных Наук — один из первых тестеров ещё чат-бота; помог множеством советов, идей и администрированием.
• Романчо — помогает структурировать многочисленные задумки, администрирует и отвечает на вопросы.
• FlyOfFly — полезные советы и наработки по Unity; в том числе помощь с ранним вводом текста.
• LoLY3_0 — кот на арбузе.
• Mr. Sub — его ролик помог многим узнать о проекте.
• Всем тестировщикам первых дней после выхода ролика, особенно smarkloker.
• スノー (v1nn1ty) и проект CrazyMitaBot — за pull requests, контакт с ботом и вклад в доступность озвучки в 2025 году.
• KASTA.

---

Топ-донатеры

⠀

Рейтинг составлен по общей сумме подписок в доступной статистике поддержки; порядок может меняться. ⠀

1. Fluttershy-2013
2. shr3der4
3. Rob Plushie
4. Hitakoto
5. Just Lucky
6. Neo
7. Sans
8. Артём Шестаков
9. ForumCore
10. Василий Бобраков

---

Особая благодарность Fluttershy-2013 за крупнейшую поддержку проекта.

Спасибо smarkloker, автору New Story Mod, за сотрудничество и обмен опытом. Желаем успеха его грядущей альфе. Спасибо GermanPlaygroud и всем тестировщикам, которые помогают находить баги и аномалии.

Поддержать проект

Boosty VinerX

Криптовалютные адреса

⠀

• Ethereum (ETH), USDT (ETH): 0xd1b91ff711f1315053f3C89EB9256eABF3Ee0377
• USDT (TRON), Tron (TRX): THi7QcfNyEmnaRzzoCpM6wyhhxvPBb5mJg
• Bitcoin (BTC): bc1q3df4zlv40dhkhuq2asmh4we9jvqlnemey5u4cw

Если удобнее поддержать другой криптовалютой, напишите VinerX в личные сообщения Discord.

Важное о правах

NeuroMita — независимый фанатский проект. Лицензия этого репозитория относится только к коду и документации, на которые у команды NeuroMita есть права. Она не предоставляет прав на MiSide, её персонажей, модели, текстуры, музыку, товарные знаки или другие сторонние материалы.

Unity-исходники не публикуются, поскольку содержат или зависят от материалов MiSide, которые команда NeuroMita не вправе распространять. Полные условия: Licence.md.