Add CLAUDE.md with deployment instructions
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
47
CLAUDE.md
Normal file
47
CLAUDE.md
Normal file
@@ -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