Skip to content

Navigation Menu

Sign in
Sign up

Repository files navigation

SIDUS

SIDUS

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.

Why SIDUS

  • ~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 & botsllms.txt, sitemap, robots, dynamic Open Graph cards.

Features

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.

Quick start

Use the site

Open https://sidus.tools — no install.

Agent skill

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.

MCP (no install)

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.

Stack

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

Architecture

×ばつ630 brand cards (static + live) │ └─► skills/sidus → Agent Skill instructions">
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

Source layout

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

Develop

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

Principles

  1. Maximum reuse — shared chrome only; tools never re-invent inputs/results.
  2. i18n everywhere — every user-facing string goes through t(...).
  3. Pure physicslib/physics/ has no React, no DOM, no side effects.
  4. Idiomatic snippets — no free-function shims; each language feels native.
  5. Theme tokens only — no raw hex in components.
  6. Catalog hygiene — catalog/URL changes update sitemap.xml + llms:gen.
  7. Educational honesty — models are for learning; not flight certification.

Documentation

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

Open Graph

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.

Author

X GitHub

Massimo De Luisa: massimo.deluisa.bio

License

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.

About

Open-source pure-SI space engineering tools: orbits, propulsion, SGP4, launch, RF, and crew ECLSS.

Topics

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

AltStyle によって変換されたページ (->オリジナル) /