Skip to content

GDS Ecosystem

The GDS ecosystem is a family of composable packages for specifying, visualizing, and analyzing complex systems.

Packages

Package Import Description
gds-framework gds Core engine — blocks, composition algebra, compiler, verification
gds-viz gds_viz Mermaid diagram renderers for GDS specifications
gds-stockflow stockflow Declarative stock-flow DSL over GDS semantics
gds-control gds_control State-space control DSL over GDS semantics
gds-games ogs Typed DSL for compositional game theory (Open Games)
gds-software gds_software Software architecture DSL (DFD, state machine, C4, ERD, etc.)
gds-business gds_business Business dynamics DSL (CLD, supply chain, value stream map)
gds-sim gds_sim Simulation engine (standalone, Pydantic-only)
gds-examples — Tutorial models demonstrating framework features

Dependency Graph

graph TD
    F[gds-framework] --> V[gds-viz]
    F --> G[gds-games]
    F --> SF[gds-stockflow]
    F --> C[gds-control]
    F --> SW[gds-software]
    F --> B[gds-business]
    F --> E[gds-examples]
    V --> E
    G --> E
    SF --> E
    C --> E
    SW --> E
    B --> E
    SIM[gds-sim]

Architecture

gds-framework  ←  core engine (no GDS dependencies)
    ↑
gds-viz        ←  visualization (depends on gds-framework)
gds-games      ←  game theory DSL (depends on gds-framework)
gds-stockflow  ←  stock-flow DSL (depends on gds-framework)
gds-control    ←  control systems DSL (depends on gds-framework)
gds-software   ←  software architecture DSL (depends on gds-framework)
gds-business   ←  business dynamics DSL (depends on gds-framework)
    ↑
gds-examples   ←  tutorials (depends on gds-framework + gds-viz + all DSLs)

gds-sim        ←  simulation engine (standalone — no gds-framework dep, only pydantic)