Bumi

📖 Installation Guide — quick start, manual setup, and troubleshooting

MCP server + REST bridge scaffold for the Noetix Bumi humanoid.

v0.2 adds /api/v1/* (health, telemetry, gated control) and mock bridge for CI/teleoperator prep. Full physical motion awaits EDU hardware + Noetix SDK topic mapping — see STATUS.md and INTEGRATION.md.

Bumi Product Info

Features (from Noetix)

• "Bumi Bumi" voice wake word + interaction
• Object recognition (RGB camera)
• One-click auto-standing on startup
• Mobile app control + visual programming
• Smart OTA updates
• Autonomous lying down / standing up
• Open Source SDK & development tools

Ordering

No direct e-commerce (no JD.com, Amazon, etc.). Noetix sells B2B through their sales team:

Pricing from 10,000 CNY (€1,300) for Lite model. Models: Lite · Air · Pro · Max · EDU-Air · EDU-Pro · EDU-Max. Price depends on model and quantity — contact sales for quote.

Architecture

PC (Goliath) ──Tailscale── Bumi (Jetson Orin)
                              │
                         rosbridge :9090
                              │
                         bumi-mcp :10774  (/api/v1)
                              │
                         Noetix SDK (walk, joints, estop)

• Mock mode: BUMI_USE_MOCK_BRIDGE=1 — no hardware (default in .env.example)
• Physical: BUMI_IP=<tailnet> + uv sync --extra robot
• Yahboom copies in ros2/, minimal_mission_executor.py — reference only, not biped-safe

Files (physical path)

Legacy Yahboom ports (reference)

Quick Start

git clone https://github.com/sandraschi/bumi-mcp
cd bumi-mcp
just

This opens an interactive dashboard showing all available commands. Run just serve with .env from .env.example (mock bridge by default).

Copy-Item .env.example .env
just serve
Invoke-RestMethod http://127.0.0.1:10774/api/v1/health
just test
just ci

Physical bot

See INTEGRATION.md — BUMI_IP, uv sync --extra robot, telemetry first, then gated motion.

License

MIT