README.md

January 21, 2026 · View on GitHub

Unity  

License Last commit Tag Top lang quality code_style

Make your Unity characters hear, think, and talk — using real voice AI. Locally. No cloud.


UnityNeuroSpeech is an open-source framework for creating fully voice-interactive AI agents inside Unity.
It connects:

  • 🧠 Whisper (STT) – converts your speech into text
  • 💬 Ollama (LLM) – generates smart responses
  • 🗣️ XTTS (TTS) – speaks back with custom voice + emotions

All locally. All offline.
No subscriptions, no accounts, no OpenAI API keys.


🚀 What can you build with UnityNeuroSpeech?

  • 🎮 AI characters that understand your voice and reply in real time
  • 🗿 NPCs with personality and memory
  • 🧪 Experiments in AI conversation and narrative design
  • 🕹️ Voice-driven gameplay mechanics
  • 🤖 Interactive bots with humanlike voice responses

✨ Core Features

FeatureDescription
🎙️ Voice InputUses whisper.unity for accurate speech-to-text
🧠 AI Brain (LLM)Easily connect to any local model via Ollama
🗣️ Custom TTSSupports any voice with Coqui XTTS
😄 EmotionsEmotion tags (<happy>, <sad>, etc.) parsed automatically from LLM
🎬 ActionsAction tags (<turn_off_lights>, <play_cutscene_123>, etc.) also parsed automatically from LLM
🎛️ Agent APISubscribe to events like BeforeTTS() to monitor your agents
📝 History Saving in JSONSave dialog history between player and LLM in JSON with/without AES encryption
🛠️ Editor ToolsCreate, manage and customize agents inside Unity Editor easily
🧱 No CloudAll models and voice run locally on your machine
🌐 MultilingualWorks with over 15+ languages, including English, Russian, Chinese, etc.
🔊 Multiple Voices and Languages for Multiple AgentsEach Agent can have each voice file for any available laguage
High PerformanceUses UniTask instead of Coroutines and Tasks for optimal performance.
🔧 Full Build SupportFull compatibility with both Mono and IL2CPP scripting backends.

🧪 Built with:


⚙️ Compatibility

Scripting backendWindowsOther platforms
Mono❌ (not planned)
IL2CPP❌ (not planned)

📚 Getting Started

See UnityNeuroSpeech official documentation.


😎 Who made this?

UnityNeuroSpeech was created by HardCodeDev — solo dev from Russia.


🗒️ License

UnityNeuroSpeech is licensed under the MIT License. For other Licenses, see Licenses.