30 lines
1.8 KiB
Markdown
30 lines
1.8 KiB
Markdown
# Slackerbot
|
|
|
|
A Slack bot that gives every DM and every channel its own AI coding agent, running in its own NixOS container.
|
|
|
|
Talk to the bot in Slack, and your message goes to a [goose](https://github.com/block/goose) agent inside a `systemd-nspawn` container. The agent's reply streams back into a Slack thread. Replying in that thread continues the same session.
|
|
|
|
- **One container per DM or channel.** DMs get a private container, and channels share one.
|
|
- **Persistent home folder.** `/root` lives on a btrfs subvolume with a guaranteed size and a cap. Everything else is rebuilt on each start.
|
|
- **Managed from Slack.** Users can `scale`, `stop`, set idle timeouts with `keep`, resize `storage`, and `move` containers between nodes. Changes are limited by per-channel permissions.
|
|
- **One or more machines.** A master runs the Slack bot, and slaves add capacity. New containers go wherever CPU, RAM and storage stay most even, and live migration moves a running container with only a short pause.
|
|
|
|
## Docs
|
|
|
|
| File | For |
|
|
| ---------------------------------- | -------------------------------------------------- |
|
|
| [INSTALLATION.md](INSTALLATION.md) | Setting up the Slack app, the host and extra nodes |
|
|
| [USERGUIDE.md](USERGUIDE.md) | Slack commands and how permissions work |
|
|
| [ARCHITECTURE.md](ARCHITECTURE.md) | How the system and the code are put together |
|
|
| [AGENTS.md](AGENTS.md) | Rules for changing the code: tests, layout, style |
|
|
|
|
## Quick start
|
|
|
|
```
|
|
git clone https://gitea.skyg.ca/ari/slacker-bot.git && cd slacker-bot
|
|
nix develop # or let direnv load it from .envrc
|
|
cd slackerbot && go test ./...
|
|
nix build .#slackerbot # the bot
|
|
nix build .#agent # the NixOS system each container boots
|
|
```
|