alloy-voice-assistant：AI Agent 工具实践指南

面对实际交付，我看alloy-voice-assistant的重点不在星标，而在这项能力：示例语音 AI 助手项目，演示如何结合 OpenAI 与 Google 服务构建对话流程，并提供本地环境配置和运行步骤。团队若要把它用于文档与演示交付，应先处理内容结构和版式在转换后容易走样，否则试用结果很容易失真。更实际的做法是拿一份结构复杂的真实文档完成转换，同时核对标题层级、表格图片、字体版式和可编辑性，不要直接在关键项目上。它更像给经常交付正式文档或演示稿的团队准备的可审查方案，是否长期使用应由试跑数据决定。

示例 AI 助手

您需要 OPENAI_API_KEY 和 GOOGLE_API_KEY 来运行此代码。将它们存储在项目根目录下的 .env 文件中，或者将它们设置为环境变量。

如果您在 Apple Silicon 上运行代码，请运行以下命令：

$ brew install portaudio

创建虚拟环境，更新pip，并安装所需的包：

$ python3 -m venv .venv
$ source .venv/bin/activate
$ pip install -U pip
$ pip install -r requirements.txt

运行助手：

$ python3 assistant.py