fxbot docs

fxbot is your bot, built and configured how you want it. It starts with a lean, fast core, works with local models as well as hosted ones, and grows with the add-ons you pick. You run it on a machine of your own, and open it there, or from your phone and other devices: Tailscale is the recommended way in, and other ways work too.

New to it? Start with the tutorial, Your first fxbot. The docs are in four parts, each for a different need.

Tutorials

A guided first run, from a fresh machine to a chat.

Your first fxbot

How-to guides

Steps for one task, when you know what you want.

Add a provider
Add a skill
Add an MCP server
Reach it from other devices
Serve it at its own name
Update to a new release
Go back to an earlier release
Back up fxbot
Run a checkout beside a release
Cut a release

Reference

Facts to look up: settings, paths, commands, providers, and changes.

Configuration
What setup.sh creates
Commands
Providers
Changelog

Explanation

How fxbot works, and why it works that way.

Core and add-ons
Security model
Releases and updates
Architecture
Bots, chats, and the library