ava-whatsapp-agent-course

把 WhatsApp 变成你的 AI 语音管家，聊天就能指挥干活

Ava 是一个基于 WhatsApp 的 AI 代理项目，旨在将 WhatsApp 转变为智能助手平台。它解决了用户在日常沟通中无法直接利用 AI 完成复杂任务的问题，例如语音交互、信息检索和自动化工作流。核心能力包括语音识别（STT）和语音合成（TTS），支持语音对话；集成向量数据库，实现语义搜索和记忆功能；采用 agentic 工作流，可编排多步骤任务。项目提供完整的课程式教程，帮助开发者从零构建类似代理。技术栈基于 Python，适合学习 agent 架构和 WhatsApp 集成。

开源 free 音频音乐

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1678

维护状态低维护

是否开源是

定价模式 free

项目数据

分类音频音乐

开发团队neural-maze

所属国家

官网地址

GitHubhttps://github.com/neural-maze/ava-whatsapp-agent-course

定价模式free

价格说明开源项目，MIT许可证，完全免费，可自行部署使用。

访问状态

是否开源是

开源协议MIT

主要语言Python

技术栈/模型agent,agent-based,agentic-workflow,agents,stt,tts,vector-database

GitHub 星标★ 1678

30天Star增速

HF 下载量

上线时间2024-12-17 00:00:00

最近更新2026-09-23 00:00:00

维护状态低维护

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数4

使用教程

难度：进阶约 30 分钟部署方式：本地安装 6 步

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

Python 环境（README 要求先创建虚拟环境）
git，用于克隆项目仓库
可访问 WhatsApp 的账号，用于收发消息
按 docs/GETTING_STARTED.md 准备依赖与配置文件

安装与启动步骤

1克隆仓库

把 Ava 课程项目拉到本地，README 中给出的仓库地址就是下面这条。
```
git clone https://github.com/neural-maze/ava-whatsapp-agent-course.git
```
2进入项目目录

切换到刚克隆下来的目录，后续所有操作都在这里执行。
```
cd ava-whatsapp-agent-course
```
3阅读入门文档

README 明确要求先看 docs/GETTING_STARTED.md，所有安装细节都在其中。
```
cat docs/GETTING_STARTED.md
```
4创建虚拟环境

README 提到需要创建虚拟环境，具体命令以 GETTING_STARTED.md 为准，勿自行改动。
5安装依赖

按 GETTING_STARTED.md 安装课程所需依赖，README 未列出具体包名，不要自行安装其他包。
6创建 .env 文件

README 要求创建 .env 并填入必要配置，变量名与取值请严格照抄入门文档。

关键配置

配置项	必填	说明	示例
`.env`	是	存放运行 Ava 所需的环境变量，具体字段见 docs/GETTING_STARTED.md	`按 GETTING_STARTED.md 填写`

如何确认成功

README 未给出启动验证方式；按 GETTING_STARTED.md 配置完成后，能收发 WhatsApp 消息即成功。

常见问题

Q：第一步该做什么？

A：先克隆仓库，再完整阅读 docs/GETTING_STARTED.md，README 强调该文档是课程能否跑通的关键。

Q：为什么教程里没有 pip install 命令？

A：README 把安装依赖等细节放在了 docs/GETTING_STARTED.md，需按该文档执行，不要自行猜测包名。

Q：学完课程能实现什么？

A：可让 Ava 收发 WhatsApp 消息、听懂语音、识别图片、回发语音条，并分享“日常活动”的图文。

Q：这是给谁学的？

A：面向想学习 agent 架构与 WhatsApp 集成的开发者，README 提供完整课程大纲。

注意事项

README 强调必须按 docs/GETTING_STARTED.md 操作，否则课程无法正常运行。
项目是课程式教程，包含多个章节，建议按 syllabus 顺序学习。
README 未提供具体安装命令、端口和依赖包名，本教程中相关步骤需以官方入门文档为准。
运行过程中会调用第三方服务（含语音识别与合成），可能产生费用，README 有专门章节说明。

核心亮点

提供完整课程，从零到一教构建 WhatsApp AI 代理，学习路径清晰
集成 STT/TTS，支持自然语音对话，交互体验流畅
使用向量数据库实现记忆和语义检索，能记住上下文

不足之处

文档/社区待观察
依赖 WhatsApp 平台，可能受官方 API 限制

适用场景

个人助理：通过 WhatsApp 语音完成日程提醒、信息查询
客服自动化：企业用 WhatsApp 机器人处理常见咨询
教学演示：学习 agent 开发和语音交互的实战项目

替代项目

Rasa、Botpress、OpenAI Assistants

项目介绍

ava-whatsapp-agent-course 是智能体领域的开源项目，由 neural-maze 开发，2024 年首次发布。

在全站 13,090 个收录项目中，它的 GitHub 星标数（1,678）位列前 30%，在智能体分类中处于中上游。

项目已超过三个月没有代码更新，维护节奏明显放缓，最近一次代码更新于 2026-09-23。MIT许可证，完全免费，可自行部署使用。

它主要面向的使用场景是：个人助理：通过WhatsApp语音完成日程提醒、信息查询。同类可对比的替代方案包括 Rasa、Botpress、OpenAI Assistants。

上一篇：smart-customer-service-system

下一篇：CodeGraph