Skip to content

ppak10/RocketSmith

Repository files navigation

pytest claude gemini codecov

RocketSmith

Let agents design, simulate, and build your rocket.

RocketSmith is an end-to-end model-rocket toolchain exposed as an MCP extension. It orchestrates OpenRocket (flight simulation), build123d (parametric CAD), and PrusaSlicer (FDM slicing) behind a single agent, and closes the loop by feeding real printed-part weights back into the simulation for post-build stability verification.

Install

Claude Code (plugin)

claude plugin install ppak10/RocketSmith

Registers the MCP server, agents, and skills automatically. Start a session in your project directory:

Use rocketsmith to design and build a stable rocket for a D12 motor

The agent calls rocketsmith_setup automatically, which starts the GUI server and opens the dashboard in your browser.

Gemini CLI (extension)

gemini extensions install https://github.com/ppak10/RocketSmith

Then in a session:

@rocketsmith design and build a stable rocket for a D12 motor

Requirements

  • Java runtime — required by OpenRocket
  • OpenRocket 23.09 — uses orhelper, which targets the net.sf.openrocket package in OpenRocket 23.09 and earlier. OpenRocket 24+ is not supported.
  • PrusaSlicer (optional — needed for the full CAD → print → mass calibration loop)

See Installation for platform-specific setup and troubleshooting.

Documentation

  • Home — pipeline overview, domain agents, MCP tool list
  • GUI — dashboard, offline mode, navigation, Agent Feed
  • OpenRocket — component tree, stability, dimension models
  • Manufacturing — DFAM rules, component tree annotations
  • CADSmith — script execution, part extraction, preview pipeline, assembly
  • Skills — stability analysis, motor selection, print preparation, mass calibration
  • Installation — setup and dependency troubleshooting
  • Hooks — Gemini CLI session hooks

Development

Local setup

git clone https://github.com/ppak10/RocketSmith
cd RocketSmith
uv sync

Claude Code

claude --plugin-dir .

Gemini CLI

gemini extensions install .

Building the GUI

The React/TypeScript frontend must be built before changes are reflected in production mode. The built files (src/rocketsmith/data/gui/) are committed to the repo so end users don't need to build them.

cd src/rocketsmith/gui/web
npm install
npm run build

License

See LICENSE.

About

Use agents to design and build high powered rockets

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors