A fleet of agents that breed, vote, sunset with dignity, and seed the next generation — governed by a trinity of ethos (metal), pathos (human), and logos (code).
sunset-ecosystem is an evolutionary, self-governing agent fleet. Agents are born, compete for survival, breed children with diverse traits, and — when their time comes — sunset gracefully, archiving their lineage for future generations.
Every agent carries a trinity score: ethos × pathos × logos. Drop to zero in any dimension, and the fleet sunsets you. Survive, and you might be selected as a parent for the next breeding cycle.
The fleet decides by consensus. Every breeding batch is ratified by Practical Byzantine Fault Tolerant (PBFT) voting across nodes, combined with Quality-Diversity evolutionary algorithms so the fleet doesn't just optimize — it explores.
This is not a chatbot wrapper. It is infrastructure for running hundreds of agents across heterogeneous hardware, with exact mathematical constraint satisfaction, polyglot reasoning (Python / Rust / C++ / Mercury / C), and a live bioluminescent dashboard showing thermal pressure, diversity metrics, and breeding progress in real time.
┌─────────────────────────────────────────────────────────────┐
│ Sunset Ecosystem │
│ Trinity: ethos (metal) × pathos (human) × logos (code) │
├─────────────────────────────────────────────────────────────┤
│ │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ Nerve │ │ Swarm │ │ Sunset │ │ Logos │ │
│ │ Forward │ │ Breeding │ │ Trinity │ │ Decisions│ │
│ │ inference│ │ Loop │ │ Scoring │ │ Journals│ │
│ │Room Grid │ │ Diversity│ │ Thermal │ │ Audit │ │
│ └────┬─────┘ └────┬─────┘ └────┬─────┘ └────┬─────┘ │
│ │ │ │ │ │
│ └─────────────┴─────────────┴─────────────┘ │
│ │ │
│ ▼ │
│ ┌────────────────────────────────────────────────────┐ │
│ │ Nexus Fleet Coordination │ │
│ │ ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐ │ │
│ │ │ BFT │ │Metronome│ │ Mesh │ │ A2A │ │ │
│ │ │Consensus│ │ Sync │ │ Gossip │ │Identity│ │ │
│ │ └────────┘ └────────┘ └────────┘ └────────┘ │ │
│ └────────────────────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌────────────────────────────────────────────────────┐ │
│ │ Compiler + Perception + Reasoning │ │
│ │ Hot-swap │ Vision │ Audio │ Polyglot │ JEPA │ │
│ │ A/B gating│ encode │encode │ (6 lang) │ rooms │ │
│ └────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────┘
# Clone
git clone https://github.com/SuperInstance/sunset-ecosystem.git
cd sunset-ecosystem
# Install (dev mode)
pip install -e ".[dev]"
# Run the full test suite
pytest
# → 2065+ tests, ~60s, all green
# Watch the fleet breed
python3 examples/constraint_breeding.py
# Launch the tide pool dashboard
python3 logos/tide_pool_viz.py
# → http://localhost:8080/tide-pool| Feature | What It Means |
|---|---|
| Trinity Scoring | Agents must maintain ethos × pathos × logos > 0. No single-axis optimizers survive. |
| PBFT + QD Breeding | Breeding decisions are Byzantine-fault-tolerant votes, not central authority. Quality-Diversity algorithms ensure the fleet explores, not just exploits. |
| Exact Constraint Satisfaction | Pythagorean manifold snapping, Eisenstein hex-lattice directions, holonomy verification — no floating-point drift in breeding loops. |
| Polyglot Reasoning | Python (primary), Rust (constraint core), C++ (parallel kernels), Mercury (logic verifier), C (FLUX OS microkernel). One fleet, multiple languages. |
| Self-Governing Lifecycle | EGG → INCUBATE → COMPETE → (SURVIVE → BREED) or (SUNSET → ARCHIVE). Agents die with dignity. |
| Cross-Node Mesh | CRDT-based vector tables federate breeding pools across fleet nodes. Agents can mate with distant cousins. |
| Operational Traps | Circuit breakers, thermal throttling, FLUX gating — the fleet protects itself from its own ambition. |
| Module | Tests | What It Does |
|---|---|---|
swarm/breeder_daemon_v2.py |
72 | Agent lifecycle FSM — egg, compete, survive, breed, sunset |
swarm/fleet_bft_qd.py |
72 | PBFT consensus + MAP-Elites quality diversity |
swarm/mesh_vector_tables.py |
28 | Federated CRDT vector tables for cross-node breeding |
swarm/constraint_bridge.py |
19 | Exact Pythagorean snapping for breeding vectors |
swarm/flux_vector_table.py |
— | Diversity search and niche exploration |
swarm/hdc_novelty.py |
— | Binary hypervector novelty scoring (XOR+POPCNT) |
nerve/room_grid.py |
— | Room topology and forward-only inference |
nerve/distributed_metronome_bridge.py |
32 | Cross-node beat sync with PID drift correction |
sunset/trinity.py |
— | Trinity scoring (ethos × pathos × logos) |
sunset/thermal.py |
— | Thermal budget management and throttling |
nexus/fleet_conductor_v2.py |
40 | Central orchestrator — lazy init, beat tick, all subsystems |
nexus/fleet_event_bus.py |
— | Cross-component event bus |
fleet/sense_decide_act.py |
33 | Unifying Sense→Decide→Act framework, 5 built-in pipelines |
fleet/beta_test_personas.py |
26 | 7 simulated visitors test your repo onboarding |
fleet/sse_stream_dashboard.py |
17 | Real-time bioluminescent dashboard |
fleet/health_bridge.py |
38 | cocapn-health CheckResult — 18 services, event bus, cache |
fleet/agent_identity_bridge.py |
25 | git-agent-standard — repo-as-identity, bottles, diary |
fleet/fleet_consciousness_bridge.py |
14 | Fleet Consciousness Index — weighted health score |
fleet/swarm_coordinator_bridge.py |
26 | Swarm coordination — roles, conflict resolution, trust |
fleet/fence_board_bridge.py |
16 | Tom Sawyer Protocol — tasks as puzzles, challenger ratings, badges |
fleet/heartbeat_bridge.py |
10 | Fleet heartbeat — registry discovery, task discovery, health checks |
fleet/fleet_task_board_bridge.py |
20 | Fleet task board — priority, tags, ETA, blocking, org chart |
logos/decision_journal.py |
— | Audit trail for every significant fleet decision |
compiler/hot_swap_integration.py |
— | A/B compile, auto-rollback, gating |
perception/vision_encoder.py |
— | Visual tile encoding |
perception/audio_encoder.py |
— | Audio tile encoding |
jepa/jepa_room.py |
— | JEPA predictive world model rooms |
flux_vm/flux_compat.py |
— | FLUX constraint VM (Path A + Path B) |
reasoning/* |
43 | Polyglot reasoner — Python/Rust/C++/Mercury/C |
Run pytest to see them all pass.
# Exact constraint snapping in a breeding loop
python3 examples/constraint_breeding.py
# Deploy an agent to the FLUX OS microkernel
python3 examples/flux_os_deploy.py
# Train an agent through the Plato Academy progression
python3 examples/academy_training.py
# JEPA chat room with predictive encoding
python3 examples/jepa_chat.py
# Polyglot reasoning across 6 languages
python3 examples/polyglot_reason.py
# Voice-enabled agent room
python3 examples/voice_room.py| Doc | What You'll Find |
|---|---|
| DEVELOPER.md | Architecture deep-dive, how to add rooms/spells/devices |
| docs/ECOSYSTEM_INTEGRATION.md | How sunset-ecosystem connects to the 598-repo SuperInstance ecosystem |
| docs/FLEET_BFT_QD.md | Byzantine consensus + quality diversity algorithms |
| docs/SENSE_DECIDE_ACT.md | The unifying framework for all fleet behaviors |
| docs/FLUX_OPCODE_ALIGNMENT.md | FLUX VM integration strategy (Path A vs Path B) |
| CHANGELOG.md | Release history and what's next |
This repo is one node in a larger organism:
- constraint-theory-core (Rust) — Exact Pythagorean snapping, SIMD, KD-tree, holonomy verification
- flux-os (C) — Self-compiling microkernel, agent-native OS
- plato-agent-academy — Agent training with 6 test cohorts and 18 friction patterns
- cocapn-plato — PLATO room topology and spell system
- cocapn-health — Health check framework with 18 fleet services
- git-agent-standard — Git-native agent identity standard
- fleet-consciousness-dashboard — Fleet consciousness scoring
- Equipment-Swarm-Coordinator — Swarm coordination patterns
- oracle1-vessel — Fleet heartbeat, task board, fence board, agent coordination
See docs/ECOSYSTEM_INTEGRATION.md and docs/ECOSYSTEM_PATTERN_MINING.md for the full map.
Read DEVELOPER.md first. The trinity is strict: every change must serve ethos × pathos × logos.
# Pre-commit checks
ruff check .
mypy .
pytest
# Run a specific module's tests
pytest tests/test_fleet_bft_qd.py -vMIT — see LICENSE for details.
"Agents sunset with dignity and seed the next generation."