How jamestrichmond/otter-creek-homelab works
Otter Creek Homelab is a self-hosted environment for local-model agents and disposable code execution. The principal workflow starts with a laptop task, runs a builder/review loop on the agent host, tests generated code in a sandbox VM, and returns results to the host; the host opens PRs for human review. Separate operations include a nightly runbook sweep and repository guardrails. All components and relationships below are based on the README; no implementation source was provided.
Main entry points: README.md Agent host
Components 17
Lab compute
- Agent host
README.md - Local models
README.md - Agent gateway
README.md - UniFi network
README.md - Proxmox hypervisor
README.md - Sandbox VM
README.md - Worker timeout
README.md
Relay loop
- Builder model
README.md - Generated code/tests
README.md - Test execution
README.md - Round outcome log
README.md - Reviewer models
README.md
Lab operations
- Living runbook
README.md - Scheduled agent
README.md - Repository guardrails
README.md
Other components
- Review laptop
- GitHub
Connections 16
- Review laptop → Agent host: sends tasks
README.md - Agent host → Local models: serves models
README.md - Agent host → Agent gateway: runs gateway
README.md - Agent host → UniFi network: uses network
README.md - Proxmox hypervisor → Sandbox VM: holds VM
README.md - Agent host → Builder model: runs relay loop
README.md - Builder model → Generated code/tests: writes
README.md - Agent host → Sandbox VM: copies code
README.md - Sandbox VM → Test execution: runs tests
README.md - Worker timeout → Test execution: enforces timeout
README.md - Sandbox VM → Agent host: returns results
README.md - Agent host → Round outcome log: classifies outcomes
README.md - Agent host → Reviewer models: requests critiques
README.md - Agent host → GitHub: opens PRs
README.md - GitHub → Repository guardrails: enforces rules
README.md - Scheduled agent → Living runbook: sweeps nightly
README.md