Open Source

Built in the open

The full runtime is public. Clone it, read it, run it, extend it.

github.com/s20sc/aeros-core
Repositories

Source code

Available Now

s20sc/aeros-core AGPL-3.0 + Apache-2.0

The main repository: governed runtime, ECM system, identity, memory, evolution, fleet, marketplace, MuJoCo sim backends, MCP server, provider SDK.

Python asyncio runtime
s20sc/governed-individuation Research

Measurement harness for the governed-individuation study — identity invariants, statistical study, one-command reproduction. Accompanies the research papers.

Research reproducibility

Coming Next

Benchmark suite + leaderboard Planned

EmbodiedGovBench — scenario YAMLs, matrix runner, scoring. Being reworked for cross-runtime comparability before it lands publicly.

Benchmark evaluation
Community ECM library Planned

Starter ECMs already ship in-repo under Apache-2.0 (ecm_library/); a community-contributed capability registry follows.

ECM community
Governed CaP-Agent0 In progress

A code-as-policy agent running inside AEROS governance — competence held equal, governance on/off measured.

Agent evaluation
Get Started

Up and running in minutes

quick start 
# Clone and set up
$ git clone https://github.com/s20sc/aeros-core.git
$ cd aeros-core
$ make setup              # venv + runtime/dev/bridge/mcp deps

# Smoke the suite
$ make test-fast

# Run the governed FastAPI bridge, in this terminal
$ make bridge-foreground

# Fresh machine? Docker instead:
$ cd docker
$ docker compose --profile bridge-sim up --build

Full walk-through in docs/QUICKSTART.md; docs/ARCHITECTURE.md covers the seven core beliefs the codebase is organised around; docs/ECM_GUIDE.md shows how to write your first governed capability module.

License

Dual-licensed, deliberately

AGPL-3.0 — the kernel

The repository as a whole. Use it, study it, modify it; if you run a modified AEROS as a network service, share your changes.

Apache-2.0 — the integration surfaces

What third parties build against: interfaces.py, providers/, mcp/, bridge/schemas/, ecm_library/, openclaw-plugin/. Writing a planner adapter, an ECM, or an MCP integration never obligates your code.

Commercial licensing is available for deployments that cannot adopt the AGPL — get in touch. External contributions will require a CLA, to keep dual licensing possible.

Contribute

Ways to get involved

Write an ECM

Build a capability module — navigation, manipulation, perception, or anything else an agent needs. Start from docs/ECM_GUIDE.md.

Add benchmark scenarios

Contribute test scenarios to EmbodiedGovBench for evaluating governed agent systems.

Improve documentation

Better docs, tutorials, and examples help everyone. Every PR counts.

Report issues

Found a bug or have a feature request? Open an issue on GitHub.