Model-definition framework for state-of-the-art text, vision, audio and multimodal machine learning models, for inference and training.
kyutai-labs/moshi
A speech-text foundation model and full-duplex spoken dialogue framework that talks and listens at the same time, with a streaming neural audio codec called Mimi.
- Stars
- 11,263
- Forks
- 1,044
- Open issues
- 97
- Last commit
- last month
What is it?
Moshi is a speech-text foundation model and full-duplex spoken dialogue framework from Kyutai. It models two audio streams at once, one for the user and one for Moshi itself, so it can speak and listen simultaneously rather than waiting for turns. Moshi also predicts text tokens for its own speech as an inner monologue, which the project credits for better generation quality.
The project includes Mimi, a streaming neural audio codec that encodes 24 kHz audio down to a 12.5 Hz representation at 1.1 kbps with an 80 ms frame size. The repository provides three inference stacks: PyTorch for research, MLX for on-device use on Mac and iPhone, and Rust for production, which also includes Mimi bindings exposed to Python as rustymimi. A web UI client, a command-line client and a Gradio demo are included, and pretrained weights are published on Hugging Face.
Running the PyTorch version requires a GPU with about 24 GB of memory, since quantization is not yet supported there. Windows is not officially supported.
Key features
- 01Full-duplex dialogue that models user and model audio streams simultaneously.
- 02Mimi streaming audio codec at 12.5 Hz and 1.1 kbps with about 80 ms frame size.
- 03PyTorch, MLX and Rust inference backends.
- 04MLX version runs locally on macOS with 4-bit or 8-bit quantized weights.
- 05Web UI, command-line and Gradio clients, plus Docker Compose for CUDA.
Use cases
- Building real-time voice assistants that can be interrupted and respond without turn-taking delays.
- Running a speech dialogue model locally on a Mac or iPhone with MLX.
- Researching streaming neural audio codecs and speech-text models.
- Using Mimi as a low-bitrate streaming audio tokenizer in Python or Rust.
Quick start
- 1
Install the PyTorch client from PyPI
pip install -U moshi - 2
Start the server (downloads the default model)
python -m moshi.server - 3
Open the web UI in your browser at localhost:8998
Things to know
- The PyTorch version does not support quantization and needs a GPU with about 24GB of memory.
- Windows is not officially supported.
- Model weights are released under CC-BY 4.0, not an open software license.
Topics
FAQ
- What is moshi?
- A speech-text foundation model and full-duplex spoken dialogue framework that talks and listens at the same time, with a streaming neural audio codec called Mimi. Moshi is a speech-text foundation model and full-duplex spoken dialogue framework from Kyutai. It models two audio streams at once, one for the user and one for Moshi itself, so it can speak and listen simultaneously rather than waiting for turns. Moshi also predicts text tokens for its own speech as an inner monologue, which the project credits for better generation quality.
- Is moshi free to use? What license does it have?
- moshi is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
- Is moshi still maintained?
- Updated within 6 months. The last commit to moshi was on Sep 9, 2026.
- What can I use moshi for?
- Building real-time voice assistants that can be interrupted and respond without turn-taking delays. Running a speech dialogue model locally on a Mac or iPhone with MLX. Researching streaming neural audio codecs and speech-text models. Using Mimi as a low-bitrate streaming audio tokenizer in Python or Rust.
- How do I install moshi?
- Install the PyTorch client from PyPI: pip install -U moshi Start the server (downloads the default model): python -m moshi.server Open the web UI in your browser at localhost:8998
- Where can I get moshi?
- The source code and installation instructions are on GitHub: https://github.com/kyutai-labs/moshi
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
Open-source text-to-speech model family by Resemble AI, with voice cloning from a short reference clip across English and many other languages.
Open-source speech recognition toolkit for offline and streaming ASR, with VAD, punctuation, speaker labels and OpenAI-compatible serving.
Python inference library for Kokoro-82M, an open-weight text-to-speech model with 82 million parameters.
Lightweight zipvoice-based TTS model for voice cloning and 48kHz speech generation, running at over 150x realtime on GPU.
Open-source voice activity detection and audio event detection (speech, singing, music) across 100+ languages, with streaming and non-streaming modes.