Skip to content

DeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.

Merge dev into PR #1679 and preserve integrated behavior

Bingxi Zhao (Frank)a5ad88c95f66
diff --cc README.md
index 8a1b0de78,6f0e5a313..59fa79614
--- a/README.md
+++ b/README.md
@@@ -846,8 -854,9 +854,11 @@@ The Memory Graph shows the whole pyrami
Settings is the operational control plane, opening on **General** for interface and model output language. Its searchable navigator links to independent pages: **Personal** covers Workspaces, Data migration, Appearance, and Usage statistics; **Learning & conversation** covers starting points, attachments, Video Learning, learner and guardian controls, Learning progress, and Memory; **Models & services** covers Providers, Language models, Task models, Embedding, Search, Voice, and Multimodal generation; **Features & integrations** covers tools, capability parameters, Partners & agents, and Knowledge & documents. **System** holds Network, Runtime status, and About; **Archived chats** lets you search, restore, or permanently delete archived conversations. Runtime status contains backend health, resident memory, and the **Readiness** matrix grading capability blockers, warnings, and suggestions. Workspaces keeps topic files and learning state separate, with verified migration and export under Data migration. A **provider** holds a vendor's address and credential for reuse by its service models; the model pages choose saved providers and configure model names and capabilities. **Task models** pin a small, fast model for background work — naming conversations and writing starting points — and resolve to the active default when empty. Voice groups speech synthesis and transcription; Multimodal generation groups image and video models. Partners & agents configures local harnesses and a remote Hermes gateway.
+**Xiaomi MiMo speech.** Add a Xiaomi MiMo provider with `https://api.xiaomimimo.com/v1` and its API key, then add `mimo-v2.5-tts` under Settings → Voice. Choose a preset such as `mimo_default`, `冰糖`, or `苏打`, use `wav` or `pcm16` output, and audition it before applying. Voice instructions control style and speaking speed. This adapter supports preset speech only; voice design and voice cloning require separate models and are not supported. If an older MiMo speech model was configured through the generic OpenAI-compatible adapter, recreate its speech entry using the Xiaomi MiMo provider so it uses the chat-completions protocol. See the [official MiMo speech guide](https://mimo.mi.com/docs/zh-CN/quick-start/usage-guide/audio/speech-synthesis-v2.5).
+
+ **MiniMax speech** — in Settings → Voice, choose MiniMax for text-to-speech and select `speech-2.8-hd`. Configure a MiniMax API key and a system or custom voice ID; the default voice is `English_expressive_narrator`. The API base defaults to `https://api.minimax.io/v1`; for the China region use `https://api.minimaxi.com/v1`. Read-aloud and voice previews use the native speech endpoint, with MP3, WAV, FLAC or PCM output, sample rate, speed and language controls. See the [MiniMax speech API](https://platform.minimax.io/docs/api-reference/speech-t2a-http) for voice IDs and account availability.
+
+
**Video Learning** under Settings → Learning & conversation defaults to the official privacy-enhanced YouTube IFrame Player. To keep playback local, set the administrator-managed Invidious API origin (for example `http://127.0.0.1:3000`), test it, select Invidious, and save. New or reopened videos pick up the provider immediately with the same material ID and progress. Invidious media is streamed through DeepTutor's byte-range proxy; upstream URLs are neither exposed to the browser nor stored on disk. If the instance fails, DeepTutor stays offline from YouTube until the learner explicitly chooses the native YouTube fallback. Public-caption tutoring is optional: install `.[video-learning]`; playback continues without it, while transcript-based **Explain here** is disabled with a reason.
<div align="center">
diff --cc deeptutor/services/config/provider_runtime.py
index 58ad5667a,1d37d2b04..6535f163c
--- a/deeptutor/services/config/provider_runtime.py
+++ b/deeptutor/services/config/provider_runtime.py
@@@ -319,13 -319,13 +319,20 @@@ class VoiceProviderSpec
# Voice providers either use the shared OpenAI-compatible adapter or a native
# protocol adapter registered by name (DashScope and Volcengine Speech TTS/STT).
TTS_PROVIDERS: dict[str, VoiceProviderSpec] = {
+ "xiaomi_mimo": VoiceProviderSpec(
+ label="Xiaomi MiMo",
+ default_api_base="https://api.xiaomimimo.com/v1",
+ adapter="mimo_tts",
+ default_model="mimo-v2.5-tts",
+ default_voice="mimo_default",
+ ),
+ "minimax": VoiceProviderSpec(
+ label="MiniMax",
+ default_api_base="https://api.minimax.io/v1",
+ adapter="minimax",
+ default_model="speech-2.8-hd",
+ default_voice="English_expressive_narrator",
+ ),
"volcengine_speech": VoiceProviderSpec(
label="Volcengine Speech (Doubao)",
default_api_base="https://openspeech.bytedance.com/api/v3",
diff --cc deeptutor/services/voice/adapters/__init__.py
index 196ce4054,31cc12374..948177ca0
--- a/deeptutor/services/voice/adapters/__init__.py
+++ b/deeptutor/services/voice/adapters/__init__.py
@@@ -12,7 -12,7 +12,8 @@@ from deeptutor.services.voice.adapters.
DashScopeSTTAdapter,
DashScopeTTSAdapter,
)
+from deeptutor.services.voice.adapters.mimo import MiMoTTSAdapter
+ from deeptutor.services.voice.adapters.minimax import MiniMaxTTSAdapter
from deeptutor.services.voice.adapters.openai_compat import (
OpenAICompatSTTAdapter,
OpenAICompatTTSAdapter,
@@@ -22,7 -22,7 +23,8 @@@ from deeptutor.services.voice.adapters.
from deeptutor.services.voice.base import BaseSTTAdapter, BaseTTSAdapter, VoiceProviderError
TTS_ADAPTERS: dict[str, BaseTTSAdapter] = {
+ "mimo_tts": MiMoTTSAdapter(),
+ "minimax": MiniMaxTTSAdapter(),
"volcengine": VolcengineTTSAdapter(),
"openai_compat": OpenAICompatTTSAdapter(),
"openrouter_tts": OpenRouterTTSAdapter(),
diff --cc deeptutor/services/voice/options.py
index eb910ab96,8de2dd03c..8ff5a9ed6
--- a/deeptutor/services/voice/options.py
+++ b/deeptutor/services/voice/options.py
@@@ -41,17 -41,27 +41,38 @@@ def preset(model: str, *, voices=None,
def _tts_models(provider: str) -> tuple[list[dict], str]:
+ if provider == "xiaomi_mimo":
+ return [
+ preset(
+ "mimo-v2.5-tts",
+ voices=choices(
+ ["mimo_default", "冰糖", "茉莉", "苏打", "白桦", "Mia", "Chloe", "Milo", "Dean"]
+ ),
+ formats=["wav", "pcm16"],
+ instructions=True,
+ )
+ ], "https://mimo.mi.com/docs/zh-CN/quick-start/usage-guide/audio/speech-synthesis-v2.5"
+ if provider == "minimax":
+ return [
+ preset(
+ model,
+ voices=choices(["English_expressive_narrator"]),
+ languages=choices(["auto", "Chinese", "English"]),
+ formats=["mp3", "wav", "flac", "pcm"],
+ sample_rates=[8000, 16000, 22050, 24000, 32000, 44100],
+ speed={"min": 0.5, "max": 2, "step": 0.05},
+ )
+ for model in [
+ "speech-2.8-hd",
+ "speech-2.8-turbo",
+ "speech-2.6-hd",
+ "speech-2.6-turbo",
+ "speech-02-hd",
+ "speech-02-turbo",
+ "speech-01-hd",
+ "speech-01-turbo",
+ ]
+ ], "https://platform.minimax.io/docs/api-reference/speech-t2a-http"
openai = [
preset(
"gpt-4o-mini-tts",