docs: add shared agent knowledgebase
This commit is contained in:
@@ -0,0 +1,75 @@
|
||||
# Runbook: start Gerhard on Omega13
|
||||
|
||||
## Preconditions
|
||||
|
||||
Expected side-by-side layout:
|
||||
|
||||
```text
|
||||
~/Projects/Agent0
|
||||
~/Projects/gutasktool
|
||||
```
|
||||
|
||||
Local `.env` exists in `Agent0` and contains non-committed credentials:
|
||||
|
||||
- `API_URL`
|
||||
- `CONTENT_API_KEY`
|
||||
- `AGENT_ID`
|
||||
- `AGENT_NAME`
|
||||
- `AGENT_PASSWORD`
|
||||
- model provider keys as needed
|
||||
|
||||
SSH config/keys on the host can push to Gitea if Gerhard is expected to push repository changes.
|
||||
|
||||
## Pull latest
|
||||
|
||||
```bash
|
||||
cd ~/Projects/Agent0
|
||||
git pull --ff-only
|
||||
cd ../gutasktool
|
||||
git pull --ff-only
|
||||
```
|
||||
|
||||
## Start Gerhard first
|
||||
|
||||
```bash
|
||||
cd ~/Projects/Agent0
|
||||
docker compose up -d gerhard gerhard-dashboard
|
||||
```
|
||||
|
||||
## Validate
|
||||
|
||||
```bash
|
||||
docker compose ps gerhard gerhard-dashboard
|
||||
docker logs gerhard --tail=100
|
||||
docker logs gerhard-dashboard --tail=100
|
||||
```
|
||||
|
||||
Check gutask wrapper:
|
||||
|
||||
```bash
|
||||
docker compose exec gerhard /opt/data/bin/gutask --help
|
||||
docker compose exec gerhard /opt/data/bin/gutask orient --agent "$AGENT_ID"
|
||||
```
|
||||
|
||||
Check shared knowledge mount:
|
||||
|
||||
```bash
|
||||
docker compose exec gerhard test -f /knowledge/README.md
|
||||
```
|
||||
|
||||
## Dashboard
|
||||
|
||||
Gerhard dashboard should be reachable from Omega13 at:
|
||||
|
||||
```text
|
||||
http://localhost:50007
|
||||
```
|
||||
|
||||
## Then tunnel and rest
|
||||
|
||||
Only after Gerhard is stable:
|
||||
|
||||
```bash
|
||||
docker compose up -d glitch-tunnel
|
||||
docker compose up -d
|
||||
```
|
||||
Reference in New Issue
Block a user