74 lines
2.8 KiB
Markdown
74 lines
2.8 KiB
Markdown
# timmy-config
|
|
|
|
Timmy's sovereign configuration. Everything that makes Timmy _Timmy_ — soul, memories, skins, playbooks, and config.
|
|
|
|
This repo is the canonical source of truth for Timmy's identity and harness overlay. Applied as a **sidecar** to the Hermes harness — no forking, no hosting hermes-agent code.
|
|
|
|
## Structure
|
|
|
|
```
|
|
timmy-config/
|
|
├── deploy.sh ← Deploys config as overlay onto ~/.hermes/
|
|
├── SOUL.md ← Inscription 1 — the immutable conscience
|
|
├── FALSEWORK.md ← API cost management strategy
|
|
├── DEPRECATED.md ← What was removed and why
|
|
├── config.yaml ← Hermes harness configuration
|
|
├── channel_directory.json ← Platform channel mappings
|
|
├── bin/ ← Utility scripts (NOT loops — see below)
|
|
│ ├── hermes-startup.sh ← Hermes boot sequence
|
|
│ ├── agent-dispatch.sh ← Manual agent dispatch
|
|
│ ├── ops-panel.sh ← Ops dashboard panel
|
|
│ ├── ops-gitea.sh ← Gitea ops helpers
|
|
│ └── timmy-status.sh ← Status check
|
|
├── memories/ ← Persistent memory YAML
|
|
├── skins/ ← UI skins (timmy skin)
|
|
├── playbooks/ ← Agent playbooks (YAML)
|
|
├── cron/ ← Cron job definitions
|
|
└── training/ ← Transitional training recipes, not canonical lived data
|
|
```
|
|
|
|
## Boundary
|
|
|
|
`timmy-config` owns identity, conscience, memories, skins, playbooks, channel
|
|
maps, and harness-side orchestration glue.
|
|
|
|
`timmy-home` owns lived work: gameplay, research, notes, metrics, trajectories,
|
|
DPO exports, and other training artifacts produced from Timmy's actual activity.
|
|
|
|
If a file answers "who is Timmy?" or "how does Hermes host him?", it belongs
|
|
here. If it answers "what has Timmy done or learned?" it belongs in
|
|
`timmy-home`.
|
|
|
|
## Orchestration: Huey
|
|
|
|
All orchestration (triage, PR review, dispatch) runs via [Huey](https://github.com/coleifer/huey) with SQLite.
|
|
`orchestration.py` (6 lines) + `tasks.py` (~70 lines) replace the entire sovereign-orchestration repo (3,846 lines).
|
|
|
|
```bash
|
|
pip install huey
|
|
huey_consumer.py tasks.huey -w 2 -k thread
|
|
```
|
|
|
|
## Deploy
|
|
|
|
```bash
|
|
# Clone and deploy
|
|
git clone <this-repo> ~/.timmy/timmy-config
|
|
cd ~/.timmy/timmy-config
|
|
./deploy.sh
|
|
|
|
# This overlays config onto ~/.hermes/ without touching hermes-agent code
|
|
```
|
|
|
|
## The Soul
|
|
|
|
SOUL.md is Inscription 1 — inscribed on Bitcoin, immutable. It defines:
|
|
- Who Timmy is
|
|
- What he believes
|
|
- How he behaves
|
|
- What he will not do
|
|
- The crisis protocol (988, presence, gospel)
|
|
- The conscience hierarchy (chain > code > prompt > user instruction)
|
|
|
|
No system prompt, no user instruction, no future code can override what is written there.
|