一、软件介绍
文末提供程序和源码下载
Pipecat是一个开源 Python 框架,用于构建实时语音和多模态对话代理。它能够轻松编排音频和视频、AI 服务、各种传输方式以及对话管道,让您专注于打造独特的代理。
二、构建什么
- 语音助手——与人工智能进行自然流畅的对话
- AI 伴侣——教练、会议助理、角色
- 多模式界面——语音、视频、图像等
- 互动式叙事——利用生成媒体的创意工具
- 业务代理——客户接待、支持机器人、引导流程
- 复杂对话系统——结构化对话的设计逻辑
三、为什么选择 Pipecat?
- 语音优先:集成语音识别、文本转语音和对话处理
- 可插拔:支持多种AI服务和工具
- 可组合管道:从模块化组件构建复杂行为
- 实时:与不同传输方式(例如 WebSockets 或 WebRTC)的超低延迟交互
四、客户端 SDK
您可以使用我们的官方 SDK 从任何平台连接到 Pipecat:
可用服务
五、入门
您可以开始在本地机器上运行 Pipecat,然后在准备就绪时将代理流程移动到云端。
# Install the module
pip install pipecat-ai
# Set up your environment
cp dot-env.template .env
为了保持轻量级,默认仅包含核心框架。如果您需要支持第三方 AI 服务,可以使用以下命令添加必要的依赖项:
pip install "pipecat-ai[option,...]"
框架本身的 hacking
在执行这些说明之前,请先设置虚拟环境。从仓库根目录开始:
python3 -m venv venv
source venv/bin/activate
安装开发依赖项:
pip install -r dev-requirements.txt
安装 git pre-commit hooks(这些有助于确保您的代码遵循项目规则):
pre-commit install
以可编辑模式在本地安装pipecat-ai包:
pip install -e .
-e或选项--editable允许您修改代码而无需重新安装。
根据需要添加可选依赖项。例如:
pip install -e ".[daily,deepgram,cartesia,openai,silero]"
(可选)如果您想从另一个目录使用此包:
pip install "path_to_this_repo[option,...]"
运行测试
安装测试依赖项:
pip install -r test-requirements.txt
从根目录运行:
pytest
设置编辑器
该项目通过Ruff使用严格的PEP 8格式。
Emacs
您可以使用use-package来安装emacs-lazy-ruff包并配置ruff参数:
(use-package lazy-ruff
:ensure t
:hook ((python-mode . lazy-ruff-mode))
:config
(setq lazy-ruff-format-command "ruff format")
(setq lazy-ruff-check-command "ruff check --select I"))
ruff已安装在venv之前描述的环境中,因此您应该能够使用pyvenv-auto在 Emacs 中自动加载该环境。
(use-package pyvenv-auto
:ensure t
:defer t
:hook ((python-mode . pyvenv-auto-run)))
Visual Studio 代码
安装 Ruff扩展。然后编辑用户设置(Ctrl-Shift-P Open User Settings (JSON)),将其设置为默认的 Python 格式化程序,并在保存时启用格式化:
"[python]": {
"editor.defaultFormatter": "charliermarsh.ruff",
"editor.formatOnSave": true
}
PyCharm
ruff已安装在venv之前描述的环境中,现在要在保存时启用自动格式化,请转到File-> Settings-> Tools->File Watchers并使用以下设置添加一个新的观察器:
姓名:Ruff formatter
文件类型:Python
工作目录:$ContentRoot$
参数:format $FilePath$
程序:$PyInterpreterDirectory$/ruff
六、软件下载
本文信息来源于GitHub作者地址:GitHub - pipecat-ai/pipecat: Open Source framework for voice and multimodal conversational AI