Open-source space engineering tools
Pure SI · multilingual · agent-ready · non-profit
skills.sh Live site MIT License AI readiness Agent Skills format MCP TypeScript React 19
Install · Agent skill · MCP · Develop · Docs
SIDUS: open-source space engineering tools
SIDUS (sidus, Latin: constellation, heavenly body) is a free educational lab for orbital mechanics, propulsion, RF/ops, geometry, and ECLSS — in the browser and for AI agents.
No accounts. No GPU. No affiliation with any space agency or company. 100% open source · non-profit.
- ~175 pure-SI calculators — Hohmann, Lambert, SGP4, link budget, cabin atmosphere, rocket equation, and many more.
- Shared UI, zero duplication — every tool is
ToolShell+ shared field/result components. - 10 languages — English, Italian, German, French, Spanish, Russian, Chinese, Japanese, Korean, Portuguese (space-agency coverage).
- Multi-language code export — C, C++, Rust, Zig, Python, JS/TS, MATLAB, Julia, Fortran, LaTeX.
- Agent-native — public MCP endpoint + Agent Skill (
skills/sidus/SKILL.md). - SEO & bots —
llms.txt, sitemap, robots, dynamic Open Graph cards.
| Area | What you get |
|---|---|
| Orbital | Circular / Hohmann / bielliptic, Lambert, Kepler, SGP4, J2 drift, look angles, pass predict, eclipse, GEO, deorbit |
| Propulsion | Rocket equation, multi-stage, Isp / thrust, propellant mass, Oberth, nozzles, electric thrusters |
| RF / ops | Link budget, antenna beamwidth, Doppler, radar equation, TTC Eb/N0, laser links |
| Crew / ECLSS | Metabolic load, cabin atmosphere, LiOH scrubber, cabin leak, thermal loop |
| Geometry / power | Angular diameter, solar array, battery, reaction wheel, ground track, coverage |
| Agents | Streamable HTTP MCP + installable skill for Claude Code, Codex, Cursor, and compatible clients |
| Export | Live values + idiomatic snippets in 10 programming languages |
Educational models only — not flight software.
Open https://sidus.tools — no install.
SIDUS ships as an Agent Skill so coding agents can run the same pure-SI calculators:
npx skills add massimodeluisa/sidus-tools
The skill lives at skills/sidus/SKILL.md. Compatible with Claude Code, Codex, Cursor, OpenCode, and other Agent Skills clients.
Point any MCP client at the public endpoint — no clone, no npm install:
https://sidus.tools/api/mcp
{
"mcpServers": {
"sidus": {
"url": "https://sidus.tools/api/mcp"
}
}
}Optional offline stdio:
git clone https://github.com/massimodeluisa/sidus-tools.git cd sidus-tools && npm install && npm run mcp
Full MCP docs: mcp/README.md.
| Layer | Choice |
|---|---|
| UI | React 19 · Vite · Tailwind CSS v4 · react-router |
| i18n | i18next (en it de fr es ru zh ja ko pt) |
| Physics | Pure TypeScript SI in src/lib/physics/ (no React) |
| Snippets | Idiomatic multi-lang export in src/lib/snippets/ |
| Agents | MCP SDK · Vercel serverless (/api/mcp) · Agent Skill |
| Social | @vercel/og dynamic cards · static OG pipeline |
Browser / agent
│
├─► sidus.tools UI → ToolShell + catalog search/filters
│ │
│ └─► lib/physics → pure SI (no React, unit-tested)
│
├─► /api/mcp → Streamable HTTP MCP (same math)
│
├─► /api/og → ×ばつ630 brand cards (static + live)
│
└─► skills/sidus → Agent Skill instructions
src/
components/shared/ ToolShell, fields, results
components/tools/ One page per calculator
components/site/ Header, footer, home, catalog
lib/physics/ Pure SI models + golden cases
lib/snippets/ Multi-lang code export
lib/og/ OG payload / catalog
data/ Tool catalog, sources, precision
i18n/locales/ All UI strings
api/ Vercel handlers (MCP, OG)
mcp/ Shared MCP server (HTTP + stdio)
skills/sidus/ Agent Skill (SKILL.md)
public/ robots, sitemap, llms, logos, favicon
npm install npm run dev # Vite dev server npm run build # type-check + production build npm run type-check npm test npm run llms:gen # regenerate public/llms.txt npm run godbolt:matrix
| Script | Purpose |
|---|---|
npm run mcp |
Local MCP over stdio |
npm run mcp:http |
Local MCP HTTP smoke |
npm run mcp:smoke |
Stdio smoke tests |
npm run og:static |
Static OG SVG/PNG pipeline |
npm run docs:check |
Doc consistency checks |
- Maximum reuse — shared chrome only; tools never re-invent inputs/results.
- i18n everywhere — every user-facing string goes through
t(...). - Pure physics —
lib/physics/has no React, no DOM, no side effects. - Idiomatic snippets — no free-function shims; each language feels native.
- Theme tokens only — no raw hex in components.
- Catalog hygiene — catalog/URL changes update
sitemap.xml+llms:gen. - Educational honesty — models are for learning; not flight certification.
| Doc | Purpose |
|---|---|
| INDEX.md | Full documentation map |
| CONVENTIONS.md | Coding, tests, i18n, catalog, SEO |
| CONTRIBUTING.md | How to contribute / PR workflow |
| AGENTS.md | Short agent entrypoint |
| skills/sidus/SKILL.md | Installable Agent Skill |
| mcp/README.md | MCP remote + stdio |
| LICENSE.md / LICENSE | MIT |
Public indexes: public/llms.txt · public/robots.txt · public/sitemap.xml
Homepage-dark cards (safe zone, large type, mono formula):
| URL | Card |
|---|---|
/api/og?page=home |
Default SIDUS brand |
/api/og?tool=hohmann |
Tool + formula (static) |
/api/og?tool=hohmann&h1=200&h2=35786&hu=km&body=earth |
Live results (Δv, TOF, ...) |
Details: docs/OG_IMAGES.md.
Massimo De Luisa: massimo.deluisa.bio
MIT, see LICENSE.
SIDUS is independent and has no affiliation with NASA, ESA, SpaceX, Roscosmos, CNSA, JAXA, ISRO, ASI, DLR, CNES, KARI, AEB, or any other agency or company.