---
pageType: source
id: source.readme
title: README
sourceType: local-file
sourcePath: /home/topher/.openclaw/workspace-crash-bot/projects/README.md
ingestedAt: 2026-05-02T21:19:31.569Z
updatedAt: 2026-05-02T21:19:31.569Z
status: active
---

# README

## Source
- Type: `local-file`
- Path: `/home/topher/.openclaw/workspace-crash-bot/projects/README.md`
- Bytes: 5779
- Updated: 2026-05-02T21:19:31.569Z

## Content
````text
# Projects Index

Cross-linked project docs. Each project gets its own file in `projects/`.

## Active Projects

| Project | Status | File | Key Tags |
|---------|--------|------|----------|
| [AI Rig Upgrade](ai-rig-upgrade.md) | Active — GPU Shopping | `ai-rig-upgrade.md` | `gpu`, `ollama`, `local-ai`, `upgrade` |
| [Brewery PID Replacement](brewery-pid-replacement.md) | Research | `brewery-pid-replacement.md` | `brewery`, `esp32-s3`, `esphome`, `pid`, `pt100` |
| [ComBadge](com-badge.md) | Research | `com-badge.md` | `esp32-s3`, `wearable`, `voice`, `pico-claw` |
| [Tricorder](tricorder.md) | Design | `tricorder.md` | `esp32-s3`, `unihiker`, `voice`, `pico-claw`, `sensors` |
| [Pi-hole Blocker](pihole-blocker.md) | Planning → Full Router | `pihole-blocker.md` | `networking`, `cm4`, `dns`, `ad-blocking`, `firewall`, `vpn`, `router` |
| [Fermentation Dashboard](fermentation-dashboard.md) | Planning | `fermentation-dashboard.md` | `brewery`, `home-assistant`, `tilt`, `grafana` |
| [Robotics Lab Pi Replacement](ROBOTICS-LAB-PI-REPLACEMENT.md) | Research | `ROBOTICS-LAB-PI-REPLACEMENT.md` | `x86`, `classroom`, `arduino`, `lattepanda` |
| [AI Desktop Companion](ai-desktop-companion.md) | Research | `ai-desktop-companion.md` | `esp32-s3`, `m5stack`, `stackchan`, `voice`, `robot` |
| [Android Head Unit OpenClaw](android-head-unit-openclaw.md) | Planning | `android-head-unit-openclaw.md` | `android`, `voice`, `car`, `head-unit`, `openclaw` |
| [Robotics Team Agent](robotics-team-agent.md) | ✅ Complete | `robotics-team-agent.md` | `openclaw`, `gitea`, `java`, `wpilib` |

## Hardware Catalog

| File | Scope |
|------|-------|
| [`../DEVICES.md`](../DEVICES.md) | Detailed hardware specs for all evaluated devices |
| [`../HARDWARE-WISHLIST.md`](../HARDWARE-WISHLIST.md) | Future / "someday" hardware finds |

## Shared Components Map

```
                    ┌─────────────────────────────┐
                    │      ESP32-S3               │
                    │  (M5StickS3 + K10 + AtomS3  │
                    │   + StackChan CoreS3)       │
                    └──────────┬──────────────────┘
                               │
              ┌────────────────┼────────────────┐─────────────────┐
              ▼                ▼                ▼                 ▼
        ┌──────────┐    ┌───────────┐    ┌──────────┐    ┌────────────┐
        │ ComBadge │    │ Tricorder │    │ AtomS3   │    │ StackChan  │
        │(M5StickS3)│   │ (K10+M10) │    │ (aux)    │    │ (CoreS3)  │
        └──────────┘    └───────────┘    └──────────┘    └────────────┘
              │                │                │                 │
              └────────────────┼────────────────┘                 │
                               │                                  │
                         ┌─────▼─────┐                    ┌─────▼─────┐
                         │ PicoClaw  │                    │ XiaoZhi   │
                         │(MicroPython│                    │ AI Agent  │
                         │ OpenClaw) │                    │ + PicoClaw│
                         └───────────┘                    └───────────┘
```

**Key shared pieces:**
- **ESP32-S3** — ComBadge (M5StickS3) + Tricorder (K10) + AtomS3 (aux component)
- **PicoClaw/PycoClaw** — ComBadge + Tricorder (both target MicroPython agent on ESP32-S3)
- **Voice pipeline** — ComBadge + Tricorder (same flow: wake word → STT → LLM → TTS)
- **M5Stack ecosystem** — ComBadge (M5StickS3) + AtomS3 (component) + StackChan (CoreS3, desktop companion)
- **DFRobot ecosystem** — Tricorder (UNIHIKER M10+K10)
- **x86 computing** — Robotics Lab Pi Replacement (LattePanda IOTA, mini PCs)

## How to Use This System

### Adding a new project
1. Create `projects/your-project.md` using the [template](#project-template) below
2. Add it to the [Active Projects table](#active-projects)
3. Link hardware to [`DEVICES.md`](../DEVICES.md) and add tags
4. Link related projects with `[[project-name.md]]` syntax

### Cross-referencing between projects
Use markdown links:
```markdown
See [[com-badge.md]] for the wearable voice badge.
```

### Tag-based lookup
Tags are listed in project frontmatter and in the Active Projects table. Search by tag to find related projects.

### Hardware overlap
Check [`DEVICES.md`](../DEVICES.md) — it tracks all evaluated hardware with specs. Project files link to the relevant sections.

## Project Template

```markdown
# Project Name

**Status:** Research / Planning / In Progress / Complete / On Hold
**Created:** YYYY-MM-DD
**Updated:** YYYY-MM-DD
**Tags:** `tag1`, `tag2`

## Summary
One-paragraph what and why.

## Hardware
- Device name — role — link to DEVICES.md section

## Software / Stack
- Framework, language, platform

## Architecture
How the pieces connect.

## Progress
- [ ] Step 1
- [ ] Step 2

## Open Questions
- Question?

## Related Projects
- [[other-project.md]] — why it's related

## Decision Log
### YYYY-MM-DD — Decision
Why and what was decided.
```

---

_Maintained by Crash-bot. Last updated: 2026-04-15_
````

## Notes
<!-- openclaw:human:start -->
<!-- openclaw:human:end -->

## Related
<!-- openclaw:wiki:related:start -->
- No related pages yet.
<!-- openclaw:wiki:related:end -->