
文末获取 开源项目源码
AICat 是一个基于乐鑫 ESP32S3主控,采用Arduino 编程,搭配1.83 寸圆角LCD屏幕,摄像头、麦克风、扬声器、四个舵机,内置 WiFi 管理、OTA 固件升级,集成阿里云 Qwen 3.5 大模型服务的软硬件全开源AI桌面机器猫项目,提供完整的 3D 打印外壳模型、Arduino 固件代码和 Python 后端服务,你可以轻松复刻一只跟能跟你实时AI语音聊天、展示多种动作、显示呆萌表情的实体机器猫。
XIAO ESP32S3 Sense 板载摄像头负责视频采集,麦克风采集语音,交给后端做 ASR 和 AI 对话。
LCD 屏幕显示状态、文字和表情动画
MAX98357A 播放 AI 回复或提示音。
PCA9685 控制嘴巴、尾巴、耳朵等普通 PWM 舵机。
STS3032 总线舵机控制四条腿,并支持走路、坐下、跳跃等动作。
AICat 开源项目涵盖按钮、LED、音频、屏幕显示等功能模块,支持语音交互与AI模型联动,你可以通过实体按键或触摸屏操作,上传程序后使用按钮切换至自定义应用,亦可将应用保存至SD卡以便重复使用,适用于教育、原型开发与智能硬件创作,具备高集成度、即用性和扩展性,适合各级别创客使用。


开发板 Seeed XIAO ESP32S3 Sense,带摄像头和麦克风版本。
屏幕 ST7789 SPI,当前代码按 170x320 屏幕调试。
MAX98357A I2S 功放模块和小喇叭。
PCA9685 16 路 PWM 舵机驱动板。
STS3032 总线舵机和对应 TTL/总线转接模块。
普通 PWM 舵机若干,用于嘴巴、尾巴、耳朵等动作。
外部舵机电源,按你的舵机规格选择,一般不要直接从 ESP32 给舵机供电。
杜邦线、面包板或自制 PCB、USB 数据线、稳定的 5V/舵机电源。
环境准备
1.安装 Python,建议 3.10以上
2.安装 Arduino IDE,增加 ESP32 开发板支持。
如果 Arduino IDE 还没有 ESP32 板卡包,打开 Arduino IDE -> Settings,在Additional boards manager URLs里加入:
https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json然后打开Tools -> Board -> Boards Manager,搜索esp32,安装esp32 by Espressif Systems。
3.安装 Arduino 依赖库。
在 Arduino IDE 打开Tools -> Manage Libraries,逐个搜索并安装这些库:
ESP32ServoAdafruit GFX LibraryAdafruit ST7735 and ST7789 LibraryAdafruit PWM Servo Driver LibraryArduinoWebsocketsJPEGDECSCServo如果 Arduino IDE 搜不到某个库,可以去库作者的 GitHub 下载 ZIP 后用“项目 -> 加载库 -> 添加 .ZIP 库”导入。
进入后端目录并安装依赖:
cd upload_facial_expression/integrated/serverpython3 -m venv .venvsource .venv/bin/activatepip install -r requirements.txt
创建本地环境变量文件,其中 DASHSCOPE_API_KEY 换成你自己的阿里云 DashScope API Key。
cat > .env << 'EOF'DASHSCOPE_API_KEY=sk-your-api-key-hereASR_DEBUG_RAW=0EOF
启动后端:
python app.py默认服务地址是:
http://0.0.0.0:8081配置 ESP32 固件
打开文件 upload_facial_expression/integrated/integrated.ino 修改 Wi-Fi 和电脑后端地址:
const char* WIFI_SSID = "YOUR_WIFI_SSID";const char* WIFI_PASS = "YOUR_WIFI_PASSWORD";const char* SERVER_HOST = "192.168.2.7";const uint16_t SERVER_PORT = 8081;
把YOUR_WIFI_SSID、YOUR_WIFI_PASSWORD换成你的 Wi-Fi把SERVER_HOST换成运行 Python 后端那台电脑的局域网 IP。
Arduino IDE 推荐设置:
Board: XIAO ESP32S3PSRAM: EnabledUSB CDC On Boot: Enabled,方便看串口日志Upload Speed:先用稳定值,如果失败再降低 Partition Scheme:上传前必须和 facial expression 写入工具保持一致,推荐 Custom或带大文件系统空间的 8MB 分区方案
确认分区表后再点击上传。烧录完成后打开串口监视器,波特率按代码或 IDE 默认设置查看日志。你应该能看到 Wi-Fi 连接和 WebSocket 连接相关输出。
🌳写在最后

https://github.com/AI-FanGe/AI_DesktopCat_Qwen3.5Omni
夜雨聆风