Fingerling

本地语音播报 MVP。

开发运行

1. 创建虚拟环境并激活：

python -m venv .venv
.venv\Scripts\Activate.ps1

2. 安装开发依赖：

pip install -e .[dev]

3. 启动 API：

uvicorn apps.api.main:app --reload

4. 调用 CLI 生成语音但不播放：

fingerling speak "今天先把 MVP 跑通" --no-play

CLI 会输出 JSON 结果，其中 audio_path 指向生成的音频文件，默认位于 runtime/audio/*.wav。

5. 运行测试：

python -m pytest -q

当前阶段

当前仓库已具备基础 API、CLI 和本地语音生成能力，MVP 主链路已经跑通，正在进入收尾与仓库同步阶段。

当前能力

• GET /health：检查 provider 就绪状态
• POST /speak：提交文本并生成音频
• fingerling speak：本地命令行生成语音
• 默认离线 Windows SAPI / pyttsx3 provider
• 音频默认输出到项目内 runtime/audio/

目标能力

以下能力属于当前 MVP 范围：

• 本地 FastAPI GET /health
• 本地 FastAPI POST /speak
• CLI 文本播报入口
• 默认离线 Windows SAPI 语音引擎