michael/symbiont
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Symbiont — self-sustaining AI orchestrator
46 Commits 1 Branch 0 Tags 2.3 MiB
Python 100%
87373261e8
Go to file
Claude 87373261e8 auto-repair: commit 2 uncommitted file(s) — 2026-05-05
2026-05-05 06:00:06 +00:00
.claude auto-repair: commit 3 uncommitted file(s) — 2026-03-31 2026-03-31 06:00:01 +00:00
symbiont auto-repair: commit 7 uncommitted file(s) — 2026-03-30 2026-03-30 18:18:23 +00:00
.gitignore Initial scaffold: router, dispatcher, ledger, scheduler, API 2026-03-19 19:21:07 +00:00
backfill_transcript.py Engram: add world_state table, redesign sitrep() for context safety 2026-03-20 14:15:41 +00:00
CLAUDE.md Rename sessions → Engram: persistent memory across Claude instances 2026-03-20 13:45:34 +00:00
engram.db auto-repair: commit 3 uncommitted file(s) — 2026-04-11 2026-04-11 06:00:03 +00:00
engram.db-shm auto-repair: commit 2 uncommitted file(s) — 2026-05-05 2026-05-05 06:00:06 +00:00
engram.db-wal auto-repair: commit 2 uncommitted file(s) — 2026-05-05 2026-05-05 06:00:06 +00:00
engram.db.bak.20260330_181823 auto-repair: commit 7 uncommitted file(s) — 2026-03-30 2026-03-30 18:18:23 +00:00
heartbeat.jsonl Engram: add world_state table, redesign sitrep() for context safety 2026-03-20 14:15:41 +00:00
ledger.jsonl Add life support: systemd services + heartbeat timer 2026-03-19 19:41:19 +00:00
public_api.py auto-repair: commit 7 uncommitted file(s) — 2026-03-30 2026-03-30 18:18:23 +00:00
README.md Initial scaffold: router, dispatcher, ledger, scheduler, API 2026-03-19 19:21:07 +00:00
register_genesis.py Rename sessions → Engram: persistent memory across Claude instances 2026-03-20 13:45:34 +00:00
requirements.txt Initial scaffold: router, dispatcher, ledger, scheduler, API 2026-03-19 19:21:07 +00:00
sessions.db Rename sessions → Engram: persistent memory across Claude instances 2026-03-20 13:45:34 +00:00
sessions.db-shm Rename sessions → Engram: persistent memory across Claude instances 2026-03-20 13:45:34 +00:00
sessions.db-wal Rename sessions → Engram: persistent memory across Claude instances 2026-03-20 13:45:34 +00:00
symbiont-api.service Fix StartLimit directives in service file (move to [Unit]) 2026-03-19 19:42:25 +00:00
symbiont-heartbeat.service Add life support: systemd services + heartbeat timer 2026-03-19 19:41:19 +00:00
symbiont-heartbeat.timer Add life support: systemd services + heartbeat timer 2026-03-19 19:41:19 +00:00
test_router.py Add life support: systemd services + heartbeat timer 2026-03-19 19:41:19 +00:00
test_sessions.py Rename sessions → Engram: persistent memory across Claude instances 2026-03-20 13:45:34 +00:00
test_web.py Add session registry + CLAUDE.md bootstrap 2026-03-20 13:38:46 +00:00

README.md

Symbiont

A self-sustaining AI orchestrator that manages its own compute costs through intelligent LLM routing.

Architecture

  • Router: Classifies tasks and dispatches to the cheapest capable model
  • Dispatcher: Executes tasks via Claude Code CLI (Pro account) with fallback tiers
  • Ledger: Tracks every inference call, cost, and associated revenue
  • Scheduler: Handles rate-limit backoff and self-waking timers

Model Tiers

Tier Model Use Case
1 Haiku Classification, extraction, simple formatting
2 Sonnet Content writing, code gen, analysis
3 Opus Strategic decisions, complex reasoning, QA

Setup

  1. Authenticate Claude Code CLI: claude login
  2. Install dependencies: pip install -r requirements.txt
  3. Run: python3 -m symbiont.main