NeuroMita 0.1 Alpha

🌐 Русский · English

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

[!IMPORTANT]

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

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

| Шаг | Что сделать | | --- | --- | | 1. Скачать | Скачайте актуальный ZIP на странице релизов и распакуйте его в отдельную папку. | | 2. Запустить | Откройте Launcher.exe; если launcher не запускается — используйте run.bat. | | 3. Подключить LLM | Создайте API-пресет в Настройки → API пресеты и сделайте его активным. | | 4. Начать диалог | Выберите персонажа в Настройки → Персонажи, затем вернитесь в чат / Sandbox. |

[!TIP]

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

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

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

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

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

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

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

Подробные списки изменений: история версий.

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

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

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

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

Что умеет NeuroMita

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

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

| Компонент | Требование | | --- | --- | | ОС | Windows 10 или Windows 11 | | Интернет | Первый запуск, обновления и облачные языковые модели | | Облачная LLM | API key выбранного сервиса | | Локальная LLM | LM Studio и достаточные ресурсы компьютера | | Озвучка и ASR | Дополнительные модели и зависимости; для ускорения часто нужна совместимая видеокарта |

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

[!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-интеграций и стабильности.

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

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

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

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

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

Boosty VinerX DonationAlerts Резервно

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

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

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

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