mindstorms-robot-creator
v0.5.0
Published
Build, code, and control LEGO MINDSTORMS robots with AI. Browser app, desktop installer, Android app, and MCP server.
Downloads
98
Maintainers
Readme
Mindstorms Robot Creator
Build, code, and connect LEGO MINDSTORMS robots. Works in the browser, as a desktop app, on Android, and as an AI agent tool.
Live Web App | Android APK | Android Repo
Download
| Platform | Link | |---|---| | Windows (.exe) | mindstorms-robot-creator-setup.exe | | macOS (.dmg) | GitHub Releases | | Linux (.AppImage) | GitHub Releases | | Android APK | mindstorms-ai-creator-latest-debug.apk | | Browser | eoinjordan.github.io/mindstorms-robot-creator |

What it does
Code Generator: Pick a robot and an action (beep, probe, drive, wave). Get runnable code in Pybricks, LEGO Stock Python, ev3dev, NXT-Python, or NQC depending on the generation. Download as .lms, .py, or .nqc.
Builder: Step through one safe test at a time. Generate code, run it, record what happened, get the next suggestion.
Connect: Bluetooth (BLE) or USB Web Serial. Works with stock LEGO firmware via LWP3 and with Pybricks for a full Python REPL.
Voice control: Load an Edge Impulse keyword-spotting model and trigger robot actions by voice in the browser.
Hardware generations
| Generation | Connection | |---|---| | Robot Inventor 51515 | BLE or USB (Pybricks / LWP3) | | SPIKE Prime | BLE or USB | | EV3 31313 | USB, Bluetooth, Wi-Fi | | NXT 1.0 / 2.0 | Bluetooth Classic or USB | | RCX | Infrared tower |
Screenshots
| Code tab | Connect tab |
|---|---|
|
|
|
| Builder tab | Voice tab |
|---|---|
|
|
|
Quick start
Browser
npx serve web-appOpen http://localhost:3000 in Chrome or Edge. Or use the hosted version at https://eoinjordan.github.io/mindstorms-robot-creator/
Desktop app
Download the installer from Releases, or build locally:
npm run electron:build:win # Windows
npm run electron:build:mac # macOS
npm run electron:build:linux # LinuxAndroid
Install the current APK from this release download. Artifact metadata is tracked in releases/android/README.md.
The public Android repo is mindstorms-robot-creator-android, package com.eoinedge.robotinventor.
Built with Kotlin and Jetpack Compose, with BLE and USB transport, session history, and voice keyword spotting. F-Droid submission pending.
Pybricks Firmware
If you choose a Pybricks code target, install or restore firmware through Pybricks:
- Pybricks Code: https://code.pybricks.com/
- Install Pybricks firmware: https://pybricks.com/learn/getting-started/install-pybricks/
- Pybricks documentation: https://docs.pybricks.com/
This project generates compatible Python and handoff steps; it does not bundle Pybricks firmware.
MCP server
For use with AI agents (Claude Desktop, VS Code Copilot, Cursor):
npx -y mindstorms-robot-creatorAdd to claude_desktop_config.json:
{
"mcpServers": {
"mindstorms-robot-creator": {
"command": "npx",
"args": ["-y", "mindstorms-robot-creator"]
}
}
}Or in .vscode/mcp.json:
{
"servers": {
"mindstorms-robot-creator": {
"type": "stdio",
"command": "node",
"args": ["${workspaceFolder}/mcp-server.js"]
}
}
}Tools
| Tool | Description |
|---|---|
| robot_scan | List robot profiles |
| robot_describe | Port map, motors, sensors, capabilities |
| robot_classify | Classify probe telemetry into a morphology |
| builder_session_start | Start a builder session |
| builder_session_append | Record an observation |
| builder_session_summary | Summarize and suggest next step |
| official_client_handoff | Steps for the LEGO or Pybricks app |
| probe_plan_create | Generate a safe probe plan |
| probe_run | Run a probe and capture telemetry |
| dataset_export | Export as Edge Impulse JSON/CSV |
| code_generate | Generate robot code |
| lms_write | Create a .lms project file |
| lms_read | Read an .lms file |
Compatibility And License
This is an independent project. It is not an official LEGO or Pybricks product, and it does not bundle Pybricks firmware, LEGO firmware, or paid third-party coding tools. It generates compatible code and handoff steps for user-selected runtimes.
Project code is MIT licensed. See LICENSE, NOTICE.md, and Compatibility And Licensing.
