VerifiedPlugin
Data
Plugin
stepparts
12,000+ open source STEP parts for your next CAD project
Plugin Signal41/100Fair
maintained53
capable14
documented50
adopted54
Install
$ npx -y skills add earthtojake/step.parts --agent claude-code
Stats
359
Stars
52
Forks
Maintained
Maintenance
TypeScript
Language
MIT
License
3mo ago
Last commit
4mo ago
Created
Repo: earthtojake/step.parts
What's inside
README
🧱 Parts
step.parts is a searchable directory of open-source STEP models for parts you can drop into CAD assemblies, robot builds, electronics layouts, and mechanical prototypes. Each catalog entry pairs a canonical STEP file with human-authored metadata and generated preview assets.
You can find components such as:
- 🔩 Fasteners and hardware: screws, nuts, washers, pins, spacers, standoffs, and threaded parts
- 📐 Stock and structural parts: extrusion profiles, plates, brackets, helper geometry, and enclosure pieces
- ⚙️ Motion and power transmission parts: bearings, gears, pulleys, shafts, belts, and linear-motion components
- 🔌 Electronics and thermal parts: development boards, modules, connectors, sensors, heatsinks, and fans
- 🤖 Actuators and robotics parts: servos, motors, robot actuators, gear reducers, and related mounting hardware
🧰 Contributions
Contributions must be made with pull requests. Create a branch, make your catalog changes locally, run the relevant checks, and open a PR for review rather than pushing directly to main.
Use the add-part helper to add STEP files to the catalog:
npm run catalog:add
The command prompts for a local STEP file path, part metadata, tags, aliases, optional standard details, and attributes. It generates the part id, copies the STEP file into the catalog, updates the source catalog, refreshes SQLite catalog metadata, exports GLB/PNG previews, and validates everything.
Preview the generated record without writing files:
npm run catalog:add -- --dry-run --step /path/to/part.step --name "Example part" --category fastener --family socket-head-cap-screw --tag screw --attr thread=M3
Before opening the PR, review:
- the new source entry in
catalog/parts.json - the canonical STEP file in
catalog/step/ - regenerated SQLite catalog in
catalog/parts.sqlite - generated preview URLs; local
public/glb/andpublic/png/files should not be committed
Then run the relevant checks:
npm run catalog:check
npm run lint
npx tsc --noEmit
See TAGGING.md for tag conventions and DEVELOPMENT.md for catalog schema, asset generation, and deployment details.
💻 Local Development
Use Node.js 22.5 or newer. The repo includes .nvmrc, so nvm use will select the same major version used by CI.
npm install
npm run dev
Open http://localhost:3000.
For catalog generation, preview assets, validation, and deployment notes, see DEVELOPMENT.md.
🧪 API
The public API lives under https://api.step.parts/v1. The app also uses the same /v1 routes locally for server-side search, filtering, downloads, and pagination.
Common lookups:
https://api.step.parts/v1/parts?pageSize=100https://api.step.parts/v1/parts?q=M3&tag=screw&page=2https://api.step.parts/v1/parts?category=fastener&family=socket-head-cap-screw&standard=ISO%204762https://api.step.parts/v1/parts?q=lengthMm%2012
Machine-readable docs are available at https://api.step.parts/v1/openapi.json, https://api.step.parts/v1/catalog/schema, and https://api.step.parts/v1/catalog/parts.index.json.
🌐 License
This repository is MIT-licensed for original project material.
Some STEP/model files are copied from, modified from, adapted from, or generated using clearly licensed third-party model sources. The MIT License does not relicense third-party-derived STEP/model files. See THIRD_PARTY_NOTICES.md for source, attribution, modification, and license details.
File tree
Showing a partial view of a very large repo.
More plugins by @earthtojake.
View @earthtojake’s profileFAQ
stepparts is a Claude Code plugin with 1 hand-picked skill for data work, indexed on Flowy. Install it with the command on its page. It includes step-parts. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.
- What is stepparts?
- 12,000+ open source STEP parts for your next CAD project
- How do I install stepparts?
- Run these in Claude Code: npx -y skills add earthtojake/step.parts --agent claude-code. Then prompt normally.
- Does stepparts auto-invoke its skills?
- Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.
- Is stepparts free?
- Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.
Is this plugin yours?
Claim it with GitHubSubmit a pluginPromote it