Skip to content

LunCoSim/lunco-sim

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

2,005 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

LunCo: virtual universe to design real space missions πŸŒŽπŸš€πŸŒš

Discord X LinkedIn YouTube License: Apache 2.0 Rust

LunCo is an open-source, high-fidelity robotics co-simulation platform built for System-Level Engineering and Concept of Operations (CONOPS). It bridges the gap between systems architecture, behavioral modeling, and real-time operations, providing the digital substrate for the next generation of space exploration.

Website | Documentation Hub | Join Discord


πŸ›° The Mission: Orchestrating CONOPS

Most simulators focus on isolated physics. LunCo focuses on the System-of-Systems. We simulate not just how a rover drives, but how it interacts with the power grid, obeys the flight software, adheres to the SysML blueprint, and contributes to the overall mission timeline.

Strategic Product Pillars

Pillar Technology The Value Proposition
System Identity SysML v2 Definitive blueprints serving as the "Source of Truth" for system structure and requirements.
Native Collaboration WebTransport Built-in, multi-user engineering. Design, test, and operate in the same scene simultaneously.
Scene Composition OpenUSD Industrial-grade 3D interop with NVIDIA Omniverse. USD is our world format, not a sim engine.
Behavioral Rigor Modelica / ROM Multi-domain behavioral simulation (power, thermal, robotics) with high-fidelity dynamics.
Mission Autonomy rhai Scenarios Hot-reloadable per-entity flight software & declarative mission timelines β€” sense and command the world through the same API as the UI.
Robot Control HIL / SIL / ROS2 Native Hardware/Software-in-the-Loop support. Bridging logical intent to physical actuators.
Mission Control XTCE / MAVLink Standardized telemetry compatible with NASA OpenMCT, YAMCS, and professional ground stations.

πŸ›  Key Capabilities

  • System-Level Co-Simulation: Orchestrate multiple specialized engines (Modelica, Avian3D, GMAT) into a single cohesive mission scenario.
  • Planetary Scale Precision: Built on a specialized f64 (double precision) spatial math foundation, ensuring absolute stability from millimetre-scale parts to lunar orbits.
  • Native Multi-User: Architecture built from the ground up for collaboration. Every edit, command, and telemetry stream is replicated across the network.
  • Headless-First & AI-Ready: Designed for automation. Scalable for massive parallel Monte Carlo analysis and end-to-end AI agent training.
  • Scriptable Autonomy: Attach hot-reloadable rhai scenarios to any entity β€” lifecycle hooks, sensing, and declarative mission timelines drive behavior with no recompile, through the same command/query API the UI and AI agents use. See the Scripting Guide.
  • Composition over Simulation: We use OpenUSD to compose complex scenes from modular parts, then attach simulation behaviors via our multi-engine backend.

🏁 Fast Track

β–Ά Try it live β€” no install

Both windowed apps also run in your browser. These are early preview builds β€” expect rough edges and missing features:

πŸ’» Run locally

git clone https://github.com/LunCoSim/lunco-sim.git
cd lunco-sim

Then launch the entry point that fits your goal (each also builds for the browser via scripts/build_web.sh):

1. LunCoSim β€” the Full Mission Simulator

The flagship: celestial bodies, ephemeris, solar-system-scale precision, and the complete flight-software / robotics / avatar stack.

cargo run --release -p luncosim

2. The Physics Sandbox

Validate robotics, suspension, and environment interactions in a collaborative 3D scene (windowed, or headless with --no-ui).

cargo run --release -p lunco-sandbox --bin sandbox

3. Lunica β€” the Engineering Workbench

Focus on Modelica modeling, schematic diagramming, and subsystem analysis.

cargo run --bin lunica

Driving it from code or an AI agent? Launch any app with --api and drive it over HTTP/MCP β€” see the AI Agent Guide and the task-oriented skills.


πŸ— Ecosystem & Governance

  • Documentation Hub β€” Usage guides and architectural deep-dives.
  • Scripting Guide β€” Write hot-reloadable rhai scenarios & mission timelines.
  • AI Agent Guide & Skills β€” Drive and extend LunCoSim from code or an AI agent.
  • Crates Index β€” A map of our 60+ specialized crates.
  • Principles β€” Our non-negotiable mandates: TDD-First, Headless-First, and Tunability.

πŸ—ΊοΈ Strategic Roadmap

Milestone Status Description
System-Level Core βœ… Foundation Multi-domain co-simulation (USD + Modelica + Avian3D) with f64 precision.
Real-world Validation πŸ“ Planned HIL/SIL Integration (Spec 027) for Hardware-in-the-loop validation.
Industrial Interop πŸ“ Planned NASA GMAT (Spec 022) for orbital mechanics and ROS2 for robotics control.
Advanced Physics πŸ“ Planned PINN-based Terramechanics (Spec 025) for high-fidelity regolith interaction.
Autonomous Missions πŸ“ Planned Agent-Driven Sim (Spec 033) and Mission Replay/Audit (Spec 020).

🀝 Community & Vision

LunCo is built by a global community of engineers and researchers making professional space engineering tools accessible to everyone.

Want to join the mission? Apply to the core team.