Typer CLI + FastAPI Gateway + Python SDK

API & CLI Reference

Production-ready interfaces for the Genesis Platform v3.0.0. Typer-based CLI with 30+ commands, FastAPI gateway with 11 routers and 64+ endpoints, Python SDK supporting local and remote modes.

30+

CLI Commands

API Routers

64+

Endpoints

Data Rooms

Quick Start

terminal

# Install Genesis Platform
pip install -e ".[all]"

# Check all data room availability
genesis status

# See all available commands
genesis --help

# Run a specific solver
genesis solve lbm --resolution 64 --steps 100

# Run PROV-specific commands
genesis thermal simulate --flux 150 --fluid genesis_gx1
genesis glass-pdk compile configs/golden_50ohm.yaml
genesis isocompiler analyze -c configs/example.yaml

# Start the FastAPI gateway
genesis serve
# Swagger UI: http://localhost:8000/docs
# ReDoc: http://localhost:8000/redoc

# Docker deployment
docker build -t genesis-platform .
docker run -p 8000:8000 genesis-platform

CLI Command Reference

Typer-based CLI with subcommands for every data room. Entry point: genesis (installed via pip install -e .)

genesis serve

Start unified FastAPI gateway (11 routers, 87 endpoints)

genesis status

Show all data room availability and solver health

genesis solve lbm

Lattice Boltzmann D2Q9 simulation

genesis solve fem

Plane stress 2D FEM analysis

genesis fab-os predict

FEM warpage prediction for EUV lithography

genesis fab-os verify-physics

Run PROV 1 physics verification suite

genesis packaging solve-kirchhoff

Von Karman nonlinear plate solver

genesis thermal simulate

Marangoni boiling simulation

genesis thermal gpu

GPU preset simulation (B200, H100, etc.)

genesis photonics firewall

Glass firewall TMM RF isolation

genesis photonics verify

Claim verification against evidence

genesis smart-matter screen

ML selectivity prediction for ligands

genesis smart-matter reactor

Kremser cascade simulation

genesis smart-matter cost

COGS estimation for production

genesis solid-state generate

Gyroid lattice generation

genesis solid-state verify-solid

Tortuosity and selectivity verification

genesis glass-pdk compile

Compile PDK from YAML config

genesis glass-pdk validate-solver

Run 177-test solver validation suite

genesis glass-pdk optimize

Pareto optimization for TGV designs

genesis glass-pdk materials

Material database query

genesis glass-pdk export

EDA export (HFSS / Sigrity)

genesis glass-pdk feasibility

Automated feasibility report

genesis isocompiler analyze

EM coupling decomposition

genesis isocompiler synthesize

Full synthesis + DRC check

genesis isocompiler optimize

Nevergrad optimization

genesis isocompiler verify

Palace full-wave verification

genesis isocompiler validate-solver

FDTD validation suite

genesis isocompiler drc

KLayout DRC check

genesis bondability run

Full GDS-to-yield pipeline

genesis bondability analyze

Multi-layer 3D analysis

genesis bondability benchmark

Validation benchmarks

genesis bondability serve

Start REST API server

REST API — Full Endpoint Reference

FastAPI gateway with 11 routers. Lazy-imports solvers to avoid loading all 9 data rooms at startup. Start with: genesis serve

Root

GET/Service info + data room list

GET/healthGlobal health check

Platform/v1/platform

GET/v1/platform/healthSolver availability check

POST/v1/platform/geometry/tpmsTPMS lattice generation

POST/v1/platform/solve/lbmLattice Boltzmann D2Q9

POST/v1/platform/solve/femPlane stress 2D FEM

POST/v1/platform/solve/fdtdFDTD 3D electromagnetic

POST/v1/platform/solve/mdMolecular dynamics

POST/v1/platform/pipeline/lbm-femThermal-structural pipeline

LPM/v1/lpm

GET/v1/lpm/healthModel status

GET/v1/lpm/metricsInference metrics

POST/v1/lpm/simulateMesh -> physics fields

Fab OS/v1/fab-os

GET/v1/fab-os/healthStatus

POST/v1/fab-os/predictFEM warpage prediction

POST/v1/fab-os/ilc/runIterative learning control

GET/v1/fab-os/cliff/{material}Physics cliff sweep data

POST/v1/fab-os/batchBatch ILC validation

Packaging OS/v1/packaging

GET/v1/packaging/healthStatus

POST/v1/packaging/solveKirchhoff solver

POST/v1/packaging/predictROM prediction

POST/v1/packaging/hexapoleHexapole field solver

POST/v1/packaging/simulateProcess history simulation

Thermal Core/v1/thermal

GET/v1/thermal/healthStatus

POST/v1/thermal/simulateMarangoni boiling sim

POST/v1/thermal/simulate-gpuGPU preset simulation

GET/v1/thermal/envelopeStability envelope

GET/v1/thermal/compareCompetitive comparison

GET/v1/thermal/fluidsSupported fluids

GET/v1/thermal/gpusSupported GPU presets

Photonics/v1/photonics

GET/v1/photonics/healthStatus

POST/v1/photonics/simulate/firewallGlass firewall TMM

POST/v1/photonics/simulate/zernikeZernike FEM sweep

POST/v1/photonics/simulate/substrateSmart substrate sim

POST/v1/photonics/simulate/neffLow-index neff analysis

GET/v1/photonics/tasks/{task_id}Poll task status

GET/v1/photonics/evidence/{claim_id}Claim evidence

POST/v1/photonics/verifyClaim verification

GET/v1/photonics/inventoryAsset inventory

Smart Matter/v1/smart-matter

GET/v1/smart-matter/healthStatus

POST/v1/smart-matter/screenML selectivity prediction

POST/v1/smart-matter/simulate-reactorKremser cascade sim

POST/v1/smart-matter/costCOGS estimation

GET/v1/smart-matter/inventoryData artifact inventory

Solid State/v1/solid-state

GET/v1/solid-state/healthStatus

POST/v1/solid-state/generate-latticeGyroid lattice generation

POST/v1/solid-state/verifyPhysics verification

POST/v1/solid-state/simulate-dendriteDendrite suppression sim

Glass PDK/v1/glass-pdk

GET/v1/glass-pdk/healthStatus

POST/v1/glass-pdk/compileCompile PDK from YAML

POST/v1/glass-pdk/validateSolver validation (579+ tests)

POST/v1/glass-pdk/optimizePareto optimization

POST/v1/glass-pdk/optimize-frequencyFrequency-targeted optimization

GET/v1/glass-pdk/materialsMaterial database

POST/v1/glass-pdk/exportEDA export bundle

Isocompiler/v1/isocompiler

GET/v1/isocompiler/healthStatus

POST/v1/isocompiler/analyzeCoupling decomposition

POST/v1/isocompiler/synthesizeFull synthesis + DRC

POST/v1/isocompiler/optimizeNevergrad optimization

POST/v1/isocompiler/verifyPalace full-wave verify

POST/v1/isocompiler/drcKLayout DRC

Bondability/v1/bondability

GET/v1/bondability/healthStatus

POST/v1/bondability/simulateFull pipeline simulation

POST/v1/bondability/optimizeYield optimization

POST/v1/bondability/validate-configConfig validation

GET/v1/bondability/jobs/{job_id}Poll job status

GET/v1/bondability/jobsList jobs

Python SDK

Supports both local (in-process) and remote (REST) modes with identical APIs. Each PROV data room also ships its own standalone CLI and SDK.

example_local.py

from genesis_sdk.v1 import GenesisSDK, LbmRequest, FemRequest

# Initialize SDK (local mode - runs solvers in-process)
sdk = GenesisSDK(mode="local")

# Run LBM Simulation
lbm_result = sdk.solve_lbm(LbmRequest(
    nx=100,
    ny=41,
    viscosity=0.02,
    inlet_velocity=0.1,
    steps=2000
))
print(f"Max velocity: {lbm_result.u_max}")
print(f"RMS Error: {lbm_result.validation_error:.2f}%")

# Run FEM Analysis
fem_result = sdk.solve_fem(FemRequest(
    nx=50,
    ny=50,
    hotspot_temp=200,
    bc_type="bottom_fixed"
))
print(f"Max stress: {fem_result.max_stress / 1e6:.1f} MPa")

# Chain LBM -> FEM pipeline
pipeline_result = sdk.run_pipeline(
    "lbm-fem",
    geometry="gyroid",
    resolution=64
)
print(f"Pipeline max stress: {pipeline_result.max_stress / 1e6:.1f} MPa")

example_remote.py

from genesis_sdk.v1 import GenesisSDK, LbmRequest

# Initialize SDK (remote mode - calls REST API)
sdk = GenesisSDK(
    mode="remote",
    base_url="https://api.nmk-ai.com",
    api_key="your-api-key"
)

# Same API, different backend
result = sdk.solve_lbm(LbmRequest(nx=100, ny=41))
print(f"Max velocity: {result.u_max}")

prov_specific_examples.py

# PROV 3: Thermal Core
from genesis_thermal_api import ThermalCore
tc = ThermalCore()
result = tc.simulate(flux=150, fluid="genesis_gx1")
print(f"Junction temp: {result.T_junction} C")

# PROV 7: Glass PDK
from glass_pdk import GlassPDK
pdk = GlassPDK.from_yaml("configs/golden_50ohm.yaml")
design = pdk.compile()
pdk.export(design, format="hfss")

# PROV 8: Isocompiler
from isocompiler import Pipeline
pipe = Pipeline.from_yaml("configs/example.yaml")
result = pipe.analyze()
synth = pipe.synthesize(result)
pipe.export_gds(synth, "output.gds")

Output Formats

JSON

API responses, simulation results, evidence artifacts

STL

3D printing, CAD import, mesh visualization

STEP

CAD/CAM, manufacturing toolpaths

VTK

ParaView scientific visualization

GDSII

Semiconductor fab masks, foundry tapeout

INP

CalculiX / Abaqus FEA input files

CSV

Data analysis, spreadsheet import

YAML

Configuration files, process parameters

Material Library

Query with: genesis glass-pdk materials or via API: GET /v1/glass-pdk/materials

Key

Name

E (GPa)

k (W/mK)

316L

Stainless Steel 316L

193 GPa

16.3 W/mK

Ti6Al4V

Titanium Grade 5

114 GPa

6.7 W/mK

AlSi10Mg

Aluminum AlSi10Mg

68 GPa

140 W/mK

Inconel718

Inconel 718

200 GPa

11.4 W/mK

CuCrZr

Copper C18150

117 GPa

320 W/mK

Tungsten

Pure Tungsten

410 GPa

173 W/mK

Dependencies & Installation

Required

numpy >= 1.24, scipy >= 1.10

fastapi >= 0.100, uvicorn >= 0.20

pydantic >= 2.0

typer >= 0.9, httpx >= 0.24

Optional Extras

[gpu] -- torch, jax

[ml] -- scikit-learn, xgboost

[viz] -- matplotlib, plotly

[glass-pdk] -- pyyaml, pandas

[isocompiler] -- nevergrad

[bondability] -- pyyaml, pandas

[dev] -- pytest, ruff, mypy

[all] -- everything above

# Installation options

pip install -e . # Core only

pip install -e ".[gpu]" # + GPU solvers

pip install -e ".[all]" # Everything

make install # Equivalent to [all]

make test # pytest (all tests)

make smoke-test # Quick import + CLI check

Ready to integrate?

Get API access and start building physics-aware applications. Full Swagger documentation at /docs.

Request API Access Learn about the Engine

Who are you?