- Shell 60.7%
- Python 39.3%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
|
|
||
| .cursor | ||
| .secret | ||
| .vscode | ||
| docs | ||
| lib | ||
| srv | ||
| .claudeignore | ||
| .cursorignore | ||
| .gitignore | ||
| AGENTS.md | ||
| INSTALL-1st-PHASE.md | ||
| INSTALL-2nd-PHASE.md | ||
| mk-ogun | ||
| ogun | ||
| ogun_do_ctl.sh | ||
| ogun_do_ctl_postboot.sh | ||
| README.md | ||
Ogun
Infrastructure agent for a TrueNAS SCALE host (kateryna). Ogun runs as a native LXC container (192.168.222.2) with Open WebUI as the chat UI, a shared identity file, and optional LLM engines that can operate the lab from on-box tools.
Sibling container: wohpe — privileged LXC for Docker / RunTipi app churn, kept off kateryna’s storage duties.
Goal
Ogun must be operable by whatever LLM engine is hooked up, with the same rules in /srv/ogun-identity.md. Prefer local tool execution on ogun over Cursor cloud VMs.
Engine priority: local models → Cursor → Claude → OpenRouter → generic APIs.
Layout (host)
ogun/ # git root + Cursor workspace folder
├── .cursor/ # LLM rules + hooks
├── AGENTS.md # Agent instructions (secrets policy)
├── .secret/ # Host/workspace credentials (gitignored)
├── .vscode/ # Multi-root workspace (ogun + wohpe)
├── ogun # Host CLI + curl|bash bootstrap
├── mk-ogun # Recreate LXC + firstboot
├── lib/ # Feature implementations (chat, do_user, …)
├── INSTALL-1st-PHASE.md # Bootstrap / first-install
├── INSTALL-2nd-PHASE.md # Engines, secrets, day-2 wiring
├── docs/ # Architecture, CLI, engine setup
├── legacy/ # Incus-era archives
└── srv/ ─────────────► /srv inside the container
├── .secret/ # Guest/engine credentials (gitignored)
├── openwebui/ # UI, pipes, identity filter
└── ogun-identity.md # Canonical agent rules
Quick start
- Phase 1 — INSTALL-1st-PHASE.md
Datasets, clone, container, provision, identity hooks,ogun_do. - Phase 2 — INSTALL-2nd-PHASE.md
Only the engines/secrets you actually want.
# On kateryna after the tree exists:
/mnt/szapps/lxc/ogun/ogun setup first-install
/mnt/szapps/lxc/ogun/ogun status --doctor
curl|bash (published raw URL):
curl -fsSL 'https://code.lksz.me/szmedia/ogun/raw/branch/main/ogun' \
| SUDO=sudo bash -s -- setup first-install --root /mnt/szapps/lxc/ogun
Day-to-day
| Command | Purpose |
|---|---|
ogun status [--doctor] |
Health / drift |
ogun host start|stop|restart |
Container + Open WebUI |
ogun chat … / ogun models |
Host → Open WebUI API |
ogun setup agents … |
Install/list default agent pipes |
ogun setup teardown |
Interactive reverse of first-install |
ogun do_user test |
Host ogun_do SSH+sudo |
ogun setup wohpe [args…] |
Fetch/run Wohpe first-install (WOHPE_REMOTE overrides repo) |
Docs under docs/ — start with ARCHITECTURE.md, OGUN-CLI.md, and OGUN_DO_USER.md.
Remote
https://code.lksz.me/szmedia/ogun
Secrets: host .secret/ + guest srv/.secret/ (paths only in git). See docs/SECRETS.md.