github.com·2026/10/21·Code-Amadeus
Amadeus 是把实时语音对话、桌面角色与 Agent 任务执行合入单一界面的本地多模态桌面代理,第一方代码以 AGPL-3.0 开源,当前为 0.17.1 Alpha 可构建源码而非成品安装包,解决语音助手、桌宠与执行代理分散多窗口、长任务过程和权限不可见的问题。它按 Talk/Embody/Act/Control 闭环设计:Main Chat 走远程 DeepSeek V4 Flash,日常与编程工作委派给 Pi(原生 RPC)、Codex App Server 等 Provider,Host 独占身份、状态、权限与持久化恢复,AUIP 协议用有界 AppSession 让 Work 产物继续受控协作。本地语音由 Qwen3-ASR 加 GPT-SoVITS 流式合成,支撑可打断对话、字幕与口型同步,角色包和模型权重不在仓库内、经 external_assets 工具单独安装。上手用 uv 按四个能力档从纯文本装到本地模型,Windows+NVIDIA cu124 为合格参考(目标 8 GiB 显存),入口是 server.app 后端与 Electron 桌面端,旧 PyQt 入口已退役。成熟度上 Windows 为参考平台,macOS/Linux 已完成源码部署验证,ROCm、cu128、Apple MPS 档均实验性,无安装器、不支持 Docker,项目报告远程 Fish Audio 首包中位延迟 3.70 s。
为什么重要 Agent 落地可借鉴:Host 权限契约、AUIP 受限会话协议与 GPT-SoVITS 推理优化均有源码和 dated 证据文档。适合 做智能体权限设计、本地语音推理与桌面集成的工程师
T4 显存目标
CUDA 12.4 兼容 GPU
远程 TTS 中位
chat.send 起算,三次试验
系统内存下限
32 GiB 推荐
视频帧缓存
静态路径 2 GiB
输出延迟
Fish Audio 自报
注释 · 3.70 s 为三次试验中位,含 DeepSeek 生成时间出自 README·硬件与延迟各节
Provider 契约、适配器与 Work 身份
会话与唤醒识别后端
Main Chat 运行时与会话集成
Electron 主进程、渲染器与设置
内嵌 GPT-SoVITS 推理基础
模型客户端与角色提示词组装
SpriteForge 适配与 PixiJS 渲染
认证本地后端、Host 控制面与 AUIP
合成、句级管线、播放与嘴形信号
$ git clone https://github.com/Code-Amadeus/Amadeus.gitcd Amadeusuv venv .venv --python 3.12
$ uv sync --locked
$ uv run --locked --no-sync python -m server.app --port 17777
$ uv sync --locked --extra local-cu124
$ uv run --locked --no-sync python tools/verify_python_environment.py --profile cu124 --require-cuda-device
$ cd electronnpm cinpm run buildnpm run electron:dev

EVIDENCE / METHODS
参数清单
远程管对话、本地管语音:主聊固定远程 DeepSeek,本地只承担 ASR 与 GPT-SoVITS
注释 · 远程与本地经模型配置切换;语音失败不静默转远程出自 README·Current capabilities