EQ-01● nominal
Orbital mechanics
Vis-viva, Kepler solvers that hold up as e → 1, anomaly conversions, Hohmann transfers, plane changes, J2 precession and Clohessy-Wiltshire motion. 63 functions and counting.
Browse equations →Skip to content01 02 03 04
// Mission: open space software
Engineering the next spacefaring stack
Open, tested building blocks for orbital mechanics and space software in TypeScript. Equations, constants, datasets and time utilities with SI units, strong types and the formula behind every function.
Trajectory · LEO → GEOhohmannTransfer()
- Δv total
- 3,893m/s
- Transfer
- 5.28h
- a transfer
- 24,421km
- Burns
- 2prograde
Subsystems
Six capabilities, each tested and documented with the equation it implements.
SI-02● nominal
Units you can trust
SI in, SI out, everywhere. Invalid domains fail loudly with actionable messages, never a quiet NaN that surfaces three modules later.
Conventions →DB-03● nominal
Constants & datasets
Physical constants from one source of truth, plus planets, moons, stars, comets, asteroids, belts, galaxies and systems, with units on every value.
Explore data →AI-04● nominal
AI assistant uplink
An MCP server exposes the toolkit to Claude, ChatGPT, Mistral Le Chat, Gemini and Copilot, so answers are computed, not guessed.
Establish uplink →TM-05● nominal
Time systems
Durations across 16 units, from attoseconds to gigayears, with aliases. The foundation for epochs and ephemerides.
Temporal →QA-06● nominal
Typed, tested, documented
Strict TypeScript with branded radians, over 500 unit tests, tree-shakeable ESM, and every equation written out in LaTeX next to its code.
Types →Flight console
Call it from code, or let your assistant call it for you.
leo-to-geo.tstypescript
import { hohmannTransfer } from '@interstellar-tools/equations';
const MU_EARTH = 3.986004418e14; // m³/s²
const { dvTotal, tTransfer } =
hohmannTransfer(6_678e3, 42_164e3, MU_EARTH);
dvTotal; // 3893 [m/s]
tTransfer / 3600; // 5.28 [h]Comms log · MCPuplink
- [T+00:00] USER: Δv from a 300 km orbit to GEO, and how long?
- [T+00:01] CALL hohmann_transfer {r1_m: 6678000, r2_m: 42164000}
- [T+00:01] ACK dv_total_m_s=3892.6 t_transfer_s=18990
- [T+00:02] ASSISTANT: About 3.89 km/s over two prograde burns, and a 5.28 h coast.
Ground stations
Supported AI assistants. Local over stdio, remote over HTTPS.
Payload manifest
| Package | Payload | Version | Status |
|---|---|---|---|
@interstellar-tools/equations | Orbits, gravity, manoeuvres, anomalies, cartography | 1.0.0 | Stable |
@interstellar-tools/constants | Physical constants and celestial datasets | 1.0.0 | Stable |
@interstellar-tools/temporal | Time unit conversion and normalisation | 1.0.0 | Stable |
@interstellar-tools/types | Shared, zero-dependency TypeScript types | 1.0.0 | Stable |
@interstellar-tools/mcp | MCP server for AI assistants | 1.0.0 | Stable |
Caution Stable since 1.0: breaking changes only come in a major release. The equations are unit-tested, but not cross-validated against flight software, so they aren't for operating real spacecraft. Tell us what you need.