需先按 docs/GETTING_STARTED.md 创建虚拟环境、装依赖并配置 .env 文件;依赖 Groq、ElevenLabs、Qdrant Cloud、Together AI 的 API Key(可用免费额度);部署到 Cloud Run 需 Google Cloud 账号

ava-whatsapp-agent-course
neural-mazeMIT长期未更新用 Python 搭建 WhatsApp 智能体 Ava 的实战课程,串联语音转写、语音合成和向量数据库,带你跑通一个能对话的 Agent 完整流程。
Meet Ava, the WhatsApp Agent
pip install -r requirements.txtREADME 未说明本地显存或 GPU 要求,模型推理走 Groq、Together AI、ElevenLabs 等云端 API,README 称可在自己电脑上免费运行
一套课程代码,教你从零搭建能收发消息、听声音、看图片的 WhatsApp AI 代理 Ava
用 Python 搭建 WhatsApp 智能体 Ava 的实战课程,串联语音转写、语音合成和向量数据库,带你跑通一个能对话的 Agent 完整流程。
核心能力
- 用 LangGraph 编排代理工作流
- 用 Qdrant 做长期记忆向量库
- 用 Whisper 做语音转文字、ElevenLabs 做文字转语音
- 用 FLUX 类扩散模型生成图片、llama-3.2-vision 理解图片
- 用 Chainlit 搭聊天界面并部署到 Cloud Run 接入 WhatsApp API
容易踩的坑
暂无 release 数据(可能没有发版,或尚未同步)。
用户点评
登录用户的真实使用记录,可按版本和硬件筛选还没有人点评。第一个说出真实体验的人最有价值。
Table of Contents
- Table of Contents
- Course Overview
- Who is this course for?
- What you'll get out of this course
- Getting started
- Course syllabus
- How much is this going to cost me?
- The tech stack
- Contributors
- License
Course Overview
What happens when two ML Engineers with a love for sci-fi movies team up? 🤔
You get Ava, a Whatsapp agent that can engage with users in a "realistic" way, inspired by the great film Ex Machina. Ok, you won't find a fully sentient robot here, but you will have some pretty interesting Whatsapp conversations.
By the end of this course, you'll have built your own Ava too, capable of:
- Receiving and sending Whatsapp messages 📲
- Understanding your voice 🗣️
- Recognizing your images 🖼️
- Sending voice notes back 🎤
- Sharing updates about its "daily activities" 🚣
- Sending you images of its current activities 🖼️
You can think of it as a modern reinterpretation of the Turing Test 🤣
Excited? Let's get started!
Who is this course for?
This course is for Software Engineers, ML Engineers, and AI Engineers who want to level up by building complex end-to-end apps. It's not just a basic "Hello World" tutorial—it's a deep dive into making a production-ready WhatsApp agent.
What you'll get out of this course
- Build a fully working WhatsApp agent you can chat with on your phone
- Get a solid understanding of how to build LangGraph workflows
- Set up a long-term memory system using Qdrant as a Vector Database
- Use Groq models to power AI Agent responses
- Implement STT systems using Whisper
- Implement TTS systems using ElevenLabs
- Generate high-quality images using diffusion models, like FLUX models
- Process images using VLM models, like llama-3.2-vision
- Create chat interfaces using Chainlit
- Deploy agentic applications to Cloud Run
- Connect agentic applications to the WhatsApp API
Getting started
Before you begin the course, there are a few things you need to do.
I'm referring to the virtual environment creation, dependencies installation, .env file creation, etc. I know, it's very boring, but it's a necessary evil! 😅
All of this is detailed in the following doc: GETTING STARTED.md.
Make sure you follow the instructions in the doc, as it's crucial for the course to work.
Course syllabus
| Lesson Number | Written Lesson | Video Lesson | Description |
|---|---|---|---|
| 1 | Project overview | Understand the project architecture and the tech stack. | |
| 2 | Dissecting Ava's brain | Learn the basics of LangGraph and implement complex workflows using this framework. | |
| 3 | Unlocking Ava's memories | Build a short-term memory system for graph state persistence and chat history. Also, implement a long-term memory system using Qdrant. | |
| 4 | Giving Ava a Voice | Build a STT and a TTS pipeline to make Ava process input and output audio. | |
| 5 | Ava learns to see | Understand how to process images using VLM models. Implement an image generation pipeline using FLUX models. | |
| 6 | Ava installs Whatsapp | Connect Ava to WhatsApp. Learn how to deploy a LangGraph application to Google Cloud Run. |
And if you're feeling extra brave, there's also a 2+ hour video course where we walk through all the project details and the code, step by step.
How much is this going to cost me?
The awesome thing about this project is you can run it on your own computer for free!
The free tiers from Groq, ElevenLabs, Qdrant Cloud, and Together AI are more than enough to get you going.
If you want to try it out on Google Cloud Run, you can get a free account and get $300 in free credits. Even if you've already used up your free credits, Cloud Run is super cheap - so it will take just a buck or two for your experiments.
The tech stack
Contributors
License
This project is licensed under the MIT License - see the LICENSE file for details.