agents

几行代码搭出能听会说的实时语音 AI 助手

开源 🏷️基础免费，高级付费 ✅ 目前可打开开发框架 🍴 复刻 4049 🐛 待处理 886 👀 关注 101

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 15056

维护状态活跃

是否开源开源

定价模式 🏷️基础免费，高级付费支持限时试用 · 开源框架免费，LiveKit Cloud 提供免费额度及付费套餐

项目预览

项目数据

分类开发框架

开发团队livekit

官网地址https://docs.livekit.io/agents

GitHubhttps://github.com/livekit/agents

定价模式🏷️基础免费，高级付费

价格说明开源框架免费，LiveKit Cloud 提供免费额度及付费套餐

访问状态✅ 目前可打开

是否开源是

开源协议Apache-2.0

主要语言Python

技术栈/模型agents,ai,openai,real-time,video,voice

GitHub 星标★ 15056

上线时间2023-10-19 00:00:00

代码更新2026-11-02

仓库体积50.7 MB

本站数据更新2026-11-02

维护状态活跃

收录时间2026-09-12

浏览次数2

项目介绍

agents 是 OpenAI 推出的开源 Python 框架，用于构建实时语音 AI 智能体。它解决的核心问题是：开发者通常需要自己拼接语音识别、大模型推理、语音合成、打断处理、多轮对话状态管理等环节，工程量大且延迟难以控制。该框架把这些能力封装成可组合的 Agent、工具调用、会话与音频管道抽象，支持实时语音输入输出、函数调用、多智能体协作与人工介入，并可与 WebRTC、电话等实时传输层对接。开发者只需定义指令、工具和语音配置，就能快速搭建能听、能说、能调用外部服务的语音助手，同时保留对底层模型和音频流的控制权，适合做客服、语音助手、实时交互类产品原型与生产落地。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-09-12 · 当前星标 ★ 15056

技术标签

agents ai openai real-time video

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

难度：入门约 15 分钟部署方式：库/依赖 4 步

环境要求

Python 环境（建议 3.9 及以上）
可用的 pip 包管理器
需要访问 LiveKit 服务与模型提供商的 API Key

安装与启动步骤

1安装核心库与插件

安装 livekit-agents 核心库，并按需选择模型提供商插件，如 openai、deepgram、cartesia。
```
pip install "livekit-agents[openai,deepgram,cartesia]"
```
2编写 Agent 脚本

README 未给出完整示例代码，需按官方文档定义指令、工具与语音配置，保存为 myagent.py。
3开发模式运行调试

开发阶段用 uv 同步全部依赖与开发工具，便于本地调试和热重载。
```
uv sync --all-extras --dev
```
4生产模式启动

以生产优化配置启动 Agent，脚本名替换为你自己的文件名。
```
python myagent.py start
```

关键配置

配置项	必填	说明	示例
`OPENAI_API_KEY`	是	调用 OpenAI 模型所需的密钥	`sk-xxxxxxxx`
`LIVEKIT_URL`	是	LiveKit 服务地址，用于接入实时传输	`wss://your-project.livekit.cloud`
`LIVEKIT_API_KEY`	是	LiveKit 项目 API Key	`APIxxxxxxxx`
`LIVEKIT_API_SECRET`	是	LiveKit 项目 API Secret	`xxxxxxxxxxxxxxxx`