| FazBrowse GitHub Viewer | Trending | | Home |
| Tools: [Download Repo ZIP] [Original HTTPS Page] |
| Name | Name | Last commit date | ||
|---|---|---|---|---|
An open-source, home-PC-compatible digital mission engineering laboratory for spacecraft analysis, Earth observation, secure mission operations, distributed infrastructure, and safety-governed workflow orchestration.
Current release: v3.1
Website: GitHub Pages-ready static site in site/
Primary workspace: OpenSat-Mission-Lab.code-workspace
OpenSat Mission Lab is a modular engineering project that demonstrates how the major parts of a modern space mission can be explored in one reproducible, open-source environment.
The project combines:
The platform is designed to run on a normal personal computer. It is intended for learning, experimentation, technical portfolios, architecture demonstrations, and open-source collaboration.
OpenSat Mission Lab is not flight-certified software, a real spacecraft command system, or a substitute for licensed ground-station infrastructure.
OpenSat Mission Lab was created to:
The v3.1 release produced the following deterministic engineering results:
| Validation area | Result |
|---|---|
| Automated repository tests | 203 passed |
| v3.1 safety controls | 28/28 passed |
| Verified approval signatures | 10 |
| Validated dual-signature bundles | 5 |
| Invalid approval attempts blocked | 3 |
| Time-bounded command grants | 2 |
| Valid command attempts allowed | 2 |
| Unsafe command attempts blocked | 5 |
| Workflow snapshots migrated | 3 |
| Command-gate model states evaluated | 256 |
| Safety invariants | 8 passed |
| Invariant violations | 0 |
| Final simulated platform state | HEALTHY |
These results apply to the deterministic project validation environment. They do not constitute independent certification of flight software, operational security, legal compliance, or spacecraft-command authority.
flowchart LR
USER[Mission Analyst or Operator]
WEB[GitHub Pages Website]
CLI[CLI and VS Code Workflows]
API[Mission Services API]
ORCH[Workflow Orchestrator]
POLICY[Policy and Safety Engine]
APPROVAL[Signed Human Approvals]
QUEUE[Job Queue]
WORKER[Mission Workers]
SCIENCE[Mission and EO Processing]
DATA[(Database and Object Storage)]
OBS[Logs Metrics Traces SLOs]
AUDIT[Hash-Chained Audit Evidence]
DASH[Static Dashboards and Reports]
USER --> WEB
USER --> CLI
CLI --> API
API --> ORCH
ORCH --> POLICY
POLICY --> APPROVAL
ORCH --> QUEUE
QUEUE --> WORKER
WORKER --> SCIENCE
SCIENCE --> DATA
API --> OBS
ORCH --> OBS
WORKER --> OBS
POLICY --> AUDIT
APPROVAL --> AUDIT
DATA --> DASH
OBS --> DASH
AUDIT --> DASH
DASH --> WEB
opensat-mission-lab/
├── .github/
│ └── workflows/ # CI, validation, security, and Pages deployment
├── .vscode/ # VS Code launch and task profiles
├── config/ # Mission, policy, security, and operations settings
├── deploy/ # Docker, Kubernetes, PostgreSQL, OPA, and telemetry assets
├── docs/ # Additional technical documentation
├── examples/ # Reproducible mission scenarios
├── outputs/ # Generated evidence and dashboards
├── policies/ # Authorization and governance policies
├── runbooks/ # Operator recovery procedures
├── scripts/ # Setup, validation, and local-serving scripts
├── site/ # Static GitHub Pages website
├── src/
│ └── opensatlab/ # Main Python package
├── tests/ # Automated test suite
├── OpenSat-Mission-Lab.code-workspace
├── ORCHESTRATION_SAFETY_ASSURANCE_GUIDE.md
├── README.md
└── pyproject.toml
Some folders may contain release-specific subdirectories and generated artifacts.
Recommended local environment:
Optional components:
The core deterministic demonstrations do not require cloud infrastructure.
git clone https://github.com/YOUR-USERNAME/YOUR-REPOSITORY.git
cd YOUR-REPOSITORYReplace YOUR-USERNAME and YOUR-REPOSITORY with the actual GitHub values.
py -m venv .venv
.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip
python -m pip install -e .The included setup script can also be used:
Set-ExecutionPolicy -Scope Process Bypass
.\scripts\setup_windows.ps1python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -e .python -m pytest -qopensat-v31-demo --output outputs/v3.1Equivalent command:
opensatlab v31-demo --output outputs/v3.1Serve the output directory:
python -m http.server 8785 --directory outputs/v3.1Open:
http://127.0.0.1:8785/v31_safety_assurance_dashboard.html
OpenSat: Run v3.1 safety-assured orchestration
To serve the dashboard, select:
OpenSat: Serve v3.1 safety-assurance dashboard
The static project website is stored in:
site/
It includes:
python -m http.server 8000 --directory siteOpen:
http://127.0.0.1:8000/
The Pages workflow publishes the contents of site/.
The public URL normally follows:
https://YOUR-USERNAME.github.io/YOUR-REPOSITORY/
| Command | Purpose |
|---|---|
| opensatlab --help | Show the main CLI |
| opensat-v31-demo | Run v3.1 safety validation |
| opensatlab v31-demo | Run v3.1 through the main CLI |
| python -m pytest -q | Run all automated tests |
| python -m http.server 8000 --directory site | Preview the website |
| python -m http.server 8785 --directory outputs/v3.1 | Serve v3.1 evidence |
Earlier release demonstrations remain available through their corresponding CLI commands and output directories.
outputs/v3.1/
├── approval_bundle_validation.csv
├── approval_signature_verification.png
├── authorization_windows.png
├── command_authorization_grants.csv
├── command_gate_decisions.csv
├── migrated_workflow_snapshots.json
├── prometheus_v31_metrics.txt
├── safety_invariant_model_check.png
├── safety_invariant_results.csv
├── safety_state_space.csv
├── separation_of_duties.png
├── separation_of_duties_attempts.csv
├── signed_approval_records.csv
├── signer_identities.csv
├── v31_safety_assurance_dashboard.html
├── v31_summary.json
├── v31_summary.txt
├── v31_validation.csv
├── workflow_definition_v31.json
├── workflow_migrations.csv
└── workflow_version_migration.png
The project emphasizes evidence-driven engineering.
A feature is considered complete only when it is accompanied by one or more of the following:
To reproduce the latest release:
python -m pytest -q
opensat-v31-demo --output outputs/v3.1Review:
outputs/v3.1/v31_summary.txt
outputs/v3.1/v31_validation.csv
outputs/v3.1/v31_safety_assurance_dashboard.html
OpenSat Mission Lab contains security and mission-safety demonstrations, but the following boundaries are essential:
Any operational adaptation requires independent systems engineering, threat modelling, legal review, radio licensing, verification, validation, and organizational authorization.
Important guides include:
Release notes and historical validation outputs document the project’s evolution.
Transmission functionality should remain disabled by default and require explicit legal and operational authorization.
Standards alignment must not be described as certification unless independently verified.
OpenSat Mission Lab demonstrates that a technically credible, multidisciplinary space-mission platform can be developed and validated on a home computer using open-source tools.
The project connects mission analysis, spacecraft modelling, Earth-observation processing, distributed services, cybersecurity, observability, multi-region resilience, human workflow orchestration, cryptographic approvals, and safety-invariant checking in one modular environment.
Its principal strength is evidence-driven implementation. Capabilities are supported by tests, scenarios, policies, machine-readable outputs, plots, dashboards, audit records, runbooks, and reproducible commands. This makes the repository useful as a technical portfolio, educational platform, systems-architecture reference, and foundation for future research.
The current implementation remains a simulator and reference architecture. It does not replace certified flight software, licensed ground systems, independent security assessment, or operational mission authority. Its value lies in making complex mission-engineering concepts transparent, testable, extensible, and accessible.
The long-term objective is to evolve OpenSat Mission Lab into an open digital mission environment where users can design missions, simulate spacecraft and ground operations, process payload data, evaluate security and safety controls, conduct failure exercises, and generate auditable engineering evidence from one integrated platform.
Contributions are welcome in areas such as:
Recommended contribution process:
Do not include operational credentials, restricted datasets, unauthorized spacecraft commands, or unlicensed transmission functionality.
Use this repository for education, research, simulation, architecture exploration, and authorized engineering work.
Do not use it to:
Add an explicit open-source LICENSE file before publishing the repository.
Suitable choices include:
After selecting a license, replace this section with:
Licensed under the [MIT](https://github.com/Samuelson777/OpenSat-Mission-Lab/blob/main/LICENSE).
A CITATION.cff file is recommended for research and academic reuse.
Suggested citation:
SAMUELSON G. OpenSat Mission Lab: An Open-Source Digital Mission
Engineering and Safety-Governed Operations Platform. Version 3.1.
Update the citation with the repository URL, release date, DOI, and additional contributors when available.
SAMUELSON G
Open-source space engineering, mission systems, scientific computing, secure software architecture, and reproducible technical research.
OpenSat Mission Lab is built with open-source scientific, geospatial, web, security, testing, and software-engineering tools. The project is intended to support learning and collaboration across the wider space and open-source communities.
| Back | FazBrowse Home | New Git URL |