# Spacebot

Spacebot is a multi-threaded AI agent harness that runs LLM agents on Discord, Slack, Telegram, and Twitch. It is open source and self-hosted, installable on Umbrel.

Canonical page: https://ourlocalhost.com/app/3573/spacebot

## Description

Spacebot is a multi-threaded AI agent harness that runs LLM agents on Discord, Slack, Telegram, and Twitch. It keeps persistent state in structured storage — a typed memory graph in SQLite — and drives autonomy with a task state machine linked to goals, capturing reusable skills from finished work. It suits teams, communities, and anyone who wants an always-on agent that improves with use.

## Platform availability

Available on 2 of 10 platforms: Umbrel, Proxmox.

## Health score

58/100 (Fair), based on 4 of 5 factors.
- Maintained: 81 (last commit 57 days ago)
- Popular: 68 (2,429 GitHub stars)
- Easy to install: 45 (2 install platforms, install notes, Docker image)
- Security check: 10 (3 serious findings, 12 minor, CI, tests)

## Security check

3 serious findings: A private key is committed in the source code; A GitHub access token is committed in the source code; Uses lettre 0.11.19, which has a known critical vulnerability.
Automated checks on commit 5c2ee47, 22 Oct 2026. Not an audit.

## Links

- Official website: https://spacebot.sh
- GitHub: https://github.com/spacedriveapp/spacebot
- Umbrel: https://apps.umbrel.com/app/spacebot

## Common questions

### Where should I put persistent command-line tools so Spacebot still has them after restarts?

Copy durable tool binaries into /data/tools/bin and avoid relying only on package managers like apt or brew. That folder is on Spacebot's PATH and survives restarts, so tools won't disappear and leave the agent unable to run them.

### How do I add a saved skill so the agent can use it?

Run spacebot skill install path/to/skill.skill in your terminal. If you skip this step, the skill's instructions and files won't be available to the agent. The skill also needs a SKILL.md with frontmatter including name and description so Spacebot can load it correctly.

### Can I run Spacebot behind Caddy when self-hosting?

A self-hosting setup guide for Ubuntu Server uses Caddy as a reverse proxy for Spacebot. It also covers building from source, systemd, model routing, and nightly auto-updates.

### Which Spacebot 0.5.0 issues are tracked for Docker or self-hosted use?

The issue list includes model allowlist behavior, an agents.permissions schema gap, channel-level fallbacks, dedicated voice-transcription endpoints, and non-atomic config writes.

---
Source: Our Local Host (https://ourlocalhost.com/app/3573/spacebot), the self-hosted and open-source app directory.
