How i3t4an/kadath works
KADATH evolves complete agent genomes through a locked, measured competition: the user configures a goal and run, approves an Architect-built benchmark, and the kernel creates and executes a population in isolated epochs. Grading informs selection and post-grade mutation; Git lineage and stored evidence preserve the run. Organisms use the vendored smolagents framework and may receive approved browser or worker capabilities. The README establishes the principal workflow and kernel responsibilities; sampled code confirms selected runtime interfaces and imports, but does not expose the full grading, selection, or recovery implementation.
Main entry points: engine.py Run kernel · agents.py Code agent · organism.py Organism entrypoint · cli.py Terminal interface
Components 26
Run control
- Terminal interface
kadath/cli.py - Run kernel
kadath/engine.py - Architect benchmark
kadath/specialists.py
Evolution loop
- Grader specialist
kadath/specialists.py - Tweaker and Birther
kadath/specialists.py - Population selection
kadath/engine.py - Genome lineage
kadath/gitstore.py - Genome mutation
kadath/mutations.py - Artifacts and evidence
kadath/artifacts.py - Run state store
kadath/store.py
Organism runtime
- Organism entrypoint
seed/organism.py - Epoch runtime
seed/kadath_runtime.py - Container entrypoint
seed/container_entrypoint.py
Execution services
- Agent executor
kadath/executors.py - Isolated containers
kadath/containers.py - Browser capability
kadath/browsers.py - Worker broker
kadath/worker_broker.py - Worker execution
kadath/workers.py
Agent framework
- Code agent
seed/smolagents/src/smolagents/agents.py - Model adapters
seed/smolagents/src/smolagents/models.py - Tools
seed/smolagents/src/smolagents/tools.py - Agent memory
seed/smolagents/src/smolagents/memory.py - Python executor
seed/smolagents/src/smolagents/local_python_executor.py - Remote executor
seed/smolagents/src/smolagents/remote_executors.py - Agent monitoring
seed/smolagents/src/smolagents/monitoring.py
Other components
- User
Connections 26
- User → Terminal interface: configures run
README.md - Terminal interface → Run kernel: starts run
kadath/cli.py - Run kernel → Architect benchmark: requests benchmark
README.md - User → Architect benchmark: approves benchmark
README.md - Run kernel → Genome lineage: records lineage
README.md - Run kernel → Agent executor: runs epoch
README.md - Agent executor → Isolated containers: isolates organism
kadath/containers.py - Isolated containers → Organism entrypoint: starts organism
README.md - Organism entrypoint → Epoch runtime: uses runtime
seed/organism.py - Organism entrypoint → Code agent: runs agent
README.md - Code agent → Model adapters: calls model
seed/smolagents/src/smolagents/agents.py - Code agent → Tools: dispatches tools
seed/smolagents/src/smolagents/agents.py - Code agent → Agent memory: records steps
seed/smolagents/src/smolagents/agents.py - Code agent → Agent monitoring: reports activity
seed/smolagents/src/smolagents/agents.py - Code agent → Python executor: uses executor
seed/smolagents/src/smolagents/agents.py - Code agent → Remote executor: uses executor
seed/smolagents/src/smolagents/agents.py - Run kernel → Grader specialist: grades attempts
README.md - Grader specialist → Population selection: scores population
README.md - Population selection → Tweaker and Birther: selects performers
README.md - Tweaker and Birther → Genome mutation: guides mutation
README.md - Run kernel → Artifacts and evidence: retains evidence
README.md - Run kernel → Run state store: stores run state
README.md - Run kernel → Browser capability: enables capability
README.md - Run kernel → Worker broker: enables workers
README.md - Worker broker → Worker execution: dispatches work
kadath/worker_broker.py - Run kernel → Container entrypoint: starts container