# 瓦力机器人

**Repository Path**: CarlYaode/walle-robots

## Basic Information

- **Project Name**: 瓦力机器人
- **Description**: 该项目含有完整技术方案与硬件文档，可自行下载并使用，禁止商业用途。
持续更新或探讨问题请发个人邮件2524951584@qq.com
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-07-22
- **Last Updated**: 2026-08-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Walle Robots · 户外 AI 瓦力机器人

个人项目：户外可移动、低延迟 AI 对话机器人（瓦力风格灵感）。

- **仓库**：https://gitee.com/CarlYaode/walle-robots
- **定位**：个人爱好 + 副业
- **当前阶段**：M0 已完成；M1 USB 串口最小闭环（电机待接）

## 文档（切换 AI 助手请先读）

| 文档 | 说明 |
|------|------|
| [docs/08-AI-HANDOFF.md](docs/08-AI-HANDOFF.md) | **给其他 AI 的交接说明** |
| [docs/02-HARDWARE-OPTIONS.md](docs/02-HARDWARE-OPTIONS.md) | 完整硬件选项 |
| [docs/03-TECH-STACK-OPTIONS.md](docs/03-TECH-STACK-OPTIONS.md) | 完整技术栈选项 |
| [docs/05-IMPLEMENTATION-ROADMAP.md](docs/05-IMPLEMENTATION-ROADMAP.md) | M0–M6 路线图 |
| [docs/README.md](docs/README.md) | 文档索引 |

## 快速开始（M0）

> 切换 AI 助手请先读 [docs/08-AI-HANDOFF.md](docs/08-AI-HANDOFF.md)。

### 1. LLM（二选一）

**方案 A：Ollama（可选）**

`powershell
ollama list
ollama serve
`

**方案 B：云端 API**：复制 config/settings.local.yaml.example 为 settings.local.yaml，填入 API Key（或环境变量 WALLE_CLOUD_API_KEY）。

### 2. 安装依赖

`powershell
py -3 -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
python scripts\check_env.py
`

### 3. 运行

`powershell
.\run.bat
`

或 scripts
un.bat / python src\main.py



| 按键 | 功能 |
|------|------|
| 空 Enter | 录音（麦克风） |
| 输入文字 + Enter | 打字对话 |
| q | 退出 |
| c | 清空历史 |
| d | 麦克风设备列表 |

## 项目结构

```
config/           # 配置（local 不提交）
docs/             # 完整方案文档
scripts/          # 启动与检查
src/
  voice/          # STT/TTS/录音
  brain/          # LLM/路由
  expression/     # 表情
  chassis/        # Mock + serial_driver（USB）
  main.py
firmware/         # ESP32-S3 motor_control（M1）
requirements.txt
```

## M1 简述（ESP32）

- 使用丝印 **USB** 口（不要用 COM/CH343）
- 烧录：scripts/flash_esp32.bat COMx
- 配置：chassis.driver: serial，chassis.serial.port（常见 COM3/4/5）
- 无电机时：发送 MOVE_FORWARD → OK + RGB 变化
- 详见 [docs/11-ESP32-USB-SERIAL.md](docs/11-ESP32-USB-SERIAL.md)

## 配置

- `config/settings.yaml` — 默认配置
- `config/settings.local.yaml` — 本地密钥（复制 example）
- 环境变量 `WALLE_CLOUD_API_KEY`

## 许可证

个人项目，文档与代码供个人学习使用。瓦力（WALL·E）为迪士尼 IP，商业用途请使用原创外形。