# 瓦力机器人

**Repository Path**: wanggudu/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-24
- **Last Updated**: 2026-07-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

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

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

- **仓库**：https://gitee.com/CarlYaode/walle-robots
- **定位**：个人爱好 + 副业
- **当前阶段**：M0 桌面 AI 大脑

## 文档（切换 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）

### 1. Ollama

```powershell
ollama list
ollama serve
```

### 2. 安装依赖

```powershell
python -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
python src\main.py
```

或双击 `scripts\run.bat`

| 按键 | 功能 |
|------|------|
| Enter | 录音 |
| q | 退出 |
| c | 清空历史 |
| d | 麦克风设备列表 |

## 项目结构

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

## 配置

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

## 许可证

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