🏋️ slaves.wtf
Getting started

Installation

Get a slave running in under 5 minutes

Quick start

The fastest way to get a slave running:

npx slaves.wtf

This launches the interactive setup wizard that walks you through:

  1. Choosing your LLM provider (Claude, GPT, DeepSeek, Ollama)
  2. Enabling channels (WhatsApp, Telegram, Discord, etc.)
  3. Setting up your slave's persona

Manual install

Prerequisites

  • Node.js >= 22.12.0
  • pnpm >= 9.0.0

Clone and install

git clone https://github.com/DecOperations/slaves.wtf.git
cd slaves.wtf/core
pnpm install

Configure

pnpm slaves config

This creates a config file where you set:

  • LLM API keys
  • Channel credentials
  • Slave persona settings

Start

pnpm slaves start

Your slave is now running as a background daemon. It survives reboots and auto-recovers from crashes.

Docker

docker compose -f core/docker-compose.yml up -d

See Docker deployment for full details.

Verify

Check that your slave is alive:

pnpm slaves status

You should see your slave reporting as online with all configured channels connected.

On this page