ava-whatsapp-agent-course

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

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 音频音乐 🍴 复刻 416 🐛 待处理 7 👀 关注 23
GitHub ↗
GitHub 星标 ★ 1683
维护状态 低维护
是否开源 开源
定价模式 🏷️完全免费 开源项目,MIT许可证,完全免费,可自行部署使用。

项目预览

ava-whatsapp-agent-course 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类音频音乐
开发团队neural-maze
定价模式🏷️完全免费
价格说明开源项目,MIT许可证,完全免费,可自行部署使用。
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言Python
技术栈/模型agent,agent-based,agentic-workflow,agents,stt,tts,vector-database
GitHub 星标★ 1683
上线时间2024-12-17 00:00:00
代码更新2025-10-20
仓库体积26.1 MB
本站数据更新2026-11-09
维护状态低维护
收录时间2026-08-09
浏览次数5

项目介绍

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

Star 增长趋势

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

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1683

使用教程

⚠ 本教程由 AI 依据该项目 README 整理;原始文档不完整,部分步骤为通用流程推断,实际安装请以项目官方文档为准。

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

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

环境要求

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

安装与启动步骤

  1. 1克隆仓库

    把 Ava 课程项目拉到本地,README 中给出的仓库地址就是下面这条。

    git clone https://github.com/neural-maze/ava-whatsapp-agent-course.git
  2. 2进入项目目录

    切换到刚克隆下来的目录,后续所有操作都在这里执行。

    cd ava-whatsapp-agent-course
  3. 3阅读入门文档

    README 明确要求先看 docs/GETTING_STARTED.md,所有安装细节都在其中。

    cat docs/GETTING_STARTED.md
  4. 4创建虚拟环境

    README 提到需要创建虚拟环境,具体命令以 GETTING_STARTED.md 为准,勿自行改动。

  5. 5安装依赖

    按 GETTING_STARTED.md 安装课程所需依赖,README 未列出具体包名,不要自行安装其他包。

  6. 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

上一篇:smart-customer-service-system

下一篇:CodeGraph

同类项目推荐

ante-preview 开源

在终端里跑一个不挑模型的智能体,干活快还不占资源。

Ghost in your shell. Ante is a self-contained agent harness with a highly optimized ···

★ 2025 2026-08-09
claude-command-center 开源

一个面板管住所有 AI 编码代理,并行开工效率翻倍

One local board for Claude Code, Codex, Cursor and 5 more coding agents. See which s···

★ 218 2026-08-09
mythos-agent-pipe 开源

让 AI 先跑通再优化,告别无限循环空转

Finish-First Autonomous Agent Loop for Claude Opus 4.7 – 2026 Edition

★ 148 2026-08-09
claude-scholar 开源

让 AI 代理帮你跑实验、写论文,一条龙搞科研

Semi-automated research assistant for academic research and software development. Su···

★ 6017 2026-10-10
LightMem 开源

给AI装上长效记忆,让对话更连贯、回答更懂你。

[ICLR 2026] LightMem: Lightweight and Efficient Memory-Augmented Generation

★ 1219 2026-08-09
learn-hermes-agent 开源

27章手把手带你从零写出会自我进化的AI智能体

A 27-chapter hands-on tutorial for building an autonomous AI agent from zero in Pyth···

★ 238 2026-08-09
bitget-wallet-skill 开源

让 AI 自动帮你换币、跨链转账,还能免 Gas 费交易

AI agent skill for Bitget Wallet — token swap, cross-chain bridge, and gasless tran···

★ 258 2026-08-09
xinchao-dynamic-mind 开源

给 AI 装上疲惫和欲望,让交互更真实

独立、可自托管的 AI 动态心智状态引擎:驱动力、念头池、疲惫、睡眠与意图。

★ 221 2026-08-09
google-meta-ads-ga4-mcp 开源

让AI直接操控你的广告账户,一句话完成投放优化与数据洞察

Google Ads MCP server + Meta Ads MCP (Facebook Ads MCP) + Google Analytics MCP (GA4)···

★ 7152 2026-08-09