How It Works Use Cases Features Integrations Skills Hub Guides Docs GitHub
How It Works

From Docker to AI fleet
in 5 minutes.

Spindrel is a single Docker Compose stack. Deploy it, create channels for your projects, add bots, and let them work.

Step 1

Deploy

terminal 
git clone https://github.com/spindrel-dev/spindrel.git
cd spindrel
./setup.sh
docker compose up

The setup wizard configures your LLM provider, API keys, and web search. Takes about 60 seconds.

Provider configuration screen Provider setup wizard
Step 2

Create Channels

Each channel is a persistent workspace — a project, a team, a topic. A channel could be your mobile app project, your marketing team, your home media server.

New Channel — Step 1: Basics 1. Basics
New Channel — Step 2: Template 2. Template
New Channel — Step 3: Integrations 3. Integrations
Step 3

Configure Your Bots

Each bot has its own personality, model, tools, and skills.

Bot identity configuration Bot identity & persona
Bot skills configuration Skills & carapaces

Same bot, different channels. One bot can work across multiple channels — each channel controls what integrations and capabilities are active.

Step 4

Activate Integrations

Toggle GitHub for dev, Slack for comms, Mission Control for projects. The bot instantly gains the tools.

1 Toggle integration on channel
→
2 Bot gains tools & skills
→
3 Start using it
Integration manager Integration manager
Channel integration toggles Per-channel activation

Browse all integrations →

Step 5

Bots Remember & Learn

Workspace files, MEMORY.md, daily logs — real files on disk, not opaque embeddings.

Workspace files

Active files injected every turn. Archives searchable via tools.

Persistent memory

MEMORY.md for stable facts. Daily logs for session journals.

Conversation history

Titled, summarized sections. Keyword and semantic search.

Channel sidebar with workspace files Channel sidebar with workspace files
History mode with archival settings and memory flush File-based history mode
Section index, archived sections, and compaction activity Section index & search
Step 6

Automate

Heartbeats, scheduled tasks, and workflows let bots act without being prompted.

Morning standup digests Automated PR reviews Weekly research summaries DevOps alerts via Slack
Task scheduler week view Task scheduler
Task configuration Task configuration
Heartbeat configuration with schedule, prompt, and dispatch settings Heartbeat configuration
Heartbeat triggering a workflow with run history Heartbeat → workflow trigger
Live workflow running in chat with step progress Workflow running in chat

Ready to build your fleet?

Deploy Spindrel, pick a use case, and start building.

Get Started Use Case Recipes → Browse Integrations →