Add CLAUDE.md with deployment instructions
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,47 @@
|
|||||||
|
# Breehavior Monitor
|
||||||
|
|
||||||
|
Discord bot for monitoring chat toxicity, topic drift, coherence, and game channel routing. Runs as a Docker container on `barge.lan`.
|
||||||
|
|
||||||
|
## Deployment
|
||||||
|
|
||||||
|
Production runs at `barge.lan:/mnt/docker/breehavior-monitor/`.
|
||||||
|
|
||||||
|
The Docker image is hosted on the Gitea registry at `git.thecozycat.net/aj/breehavior-monitor:latest`. The `config.yaml` is volume-mounted (not baked into the image).
|
||||||
|
|
||||||
|
### Steps
|
||||||
|
|
||||||
|
1. **Push code** to Gitea (origin):
|
||||||
|
```bash
|
||||||
|
git push origin master
|
||||||
|
```
|
||||||
|
|
||||||
|
2. **Build and push** the Docker image:
|
||||||
|
```bash
|
||||||
|
docker build -t git.thecozycat.net/aj/breehavior-monitor:latest .
|
||||||
|
docker push git.thecozycat.net/aj/breehavior-monitor:latest
|
||||||
|
```
|
||||||
|
|
||||||
|
3. **Copy config.yaml** to barge (it's volume-mounted, not in the image):
|
||||||
|
```bash
|
||||||
|
scp config.yaml aj@barge.lan:/mnt/docker/breehavior-monitor/config.yaml
|
||||||
|
```
|
||||||
|
|
||||||
|
4. **Pull and restart** on barge:
|
||||||
|
```bash
|
||||||
|
ssh aj@barge.lan "cd /mnt/docker/breehavior-monitor && docker compose pull && docker compose up -d"
|
||||||
|
```
|
||||||
|
|
||||||
|
5. **Verify** the bot started:
|
||||||
|
```bash
|
||||||
|
ssh aj@barge.lan "docker logs bcs-bot --tail 10"
|
||||||
|
```
|
||||||
|
|
||||||
|
### Config-only changes
|
||||||
|
|
||||||
|
If only `config.yaml` changed (no code changes), skip steps 1-2 and just do steps 3-4. The config is mounted as a volume so a container restart picks it up.
|
||||||
|
|
||||||
|
## Architecture
|
||||||
|
|
||||||
|
- **LLM backend**: llama.cpp on `athena.lan:11434` (text mode must be active)
|
||||||
|
- **Database**: MSSQL Express in a separate container (`bcs-mssql`) on barge — only used for local dev. Production DB is already running on barge.
|
||||||
|
- **Prompts**: `prompts/*.txt` — loaded at import time, so code changes require a container rebuild
|
||||||
Reference in New Issue
Block a user