# StellarGen

> Procedural planetary system generator powered by real astrophysics. Generate complete stellar and planetary systems from a single integer seed — deterministic and reproducible.

## What is StellarGen?

StellarGen is a web-based tool and API that procedurally generates scientifically grounded stellar systems from a single integer seed. Every property — spectral type, luminosity, radius, mass, orbital mechanics, planetary atmospheres, moons, rings — is derived from real astrophysical formulas, not lookup tables.

## Key features

- **Deterministic generation**: the same seed always produces the same system
- **Real astrophysics**: CODATA 2018 / IAU 2015 constants, stellar evolution models, habitable zone calculations
- **Full system coverage**: single, binary, triple and quadruple star systems; white dwarfs, neutron stars, black holes
- **Planetary systems**: semi-major axis, eccentricity, equilibrium temperature, atmospheric retention, moons, rings
- **250+ fields computed per system**
- **9.2 × 10¹⁸ unique seeds**

## Use cases

- Procedural world-building for games and simulations
- Scientific education and visualization
- Research tooling for stellar population studies
- Game development (RPGs, space sims, 4X games)

## Technical details

- Python backend (FastAPI + Pydantic v2)
- Three.js interactive 3D visualization (vanilla JS)
- REST API: `GET /GenerateStellarSystem?seed=<int>`
- Open source

## Status

Currently in development. Launch notification available at https://stellargen.space