# Crumble

> Self-hosted personal AI bots with persistent memory, continuous chats, and isolated workspaces.

## Docs

- [Crumble](https://docs.crumbli.ng/): Self-hosted bots with their own identity, memory, and one continuous chat with you.

## Get started

- [Install the Server](https://docs.crumbli.ng/getting-started/server): Run the Crumble server with Docker or Bun and create your account.
- [Connect a Model Provider](https://docs.crumbli.ng/getting-started/providers): Give your account access to a model with an API key, a provider account, or Claude Code.
- [Create Your First Bot](https://docs.crumbli.ng/getting-started/first-bot): Give a bot a name, a model, and instructions, then start chatting.

## Use Crumble

- [Bots](https://docs.crumbli.ng/concepts): What a bot is, and the capabilities you can turn on for each one.
- [Chats and History](https://docs.crumbli.ng/concepts/chats): How a bot chat lasts indefinitely, what the bot sees on each turn, and how it finds earlier messages.
- [Group Chats](https://docs.crumbli.ng/concepts/group-chats): Talk to two to six bots at once in a shared transcript.
- [Memory and Skills](https://docs.crumbli.ng/concepts/memory-and-skills): How bots remember facts, learn reusable instructions, and how you undo what they learned.
- [Workspaces and Jobs](https://docs.crumbli.ng/concepts/workspaces): How bots write code and use a desktop in their own Linux workspace, and how you take control.
- [Credentials](https://docs.crumbli.ng/concepts/credentials): Let a bot and its coding jobs use an API key without the key entering the workspace.
- [Logins](https://docs.crumbli.ng/concepts/logins): Let a bot's desktop jobs sign in to websites without the bot seeing the password.
- [Password Managers](https://docs.crumbli.ng/concepts/password-managers): Read every secret you enter in Crumble, such as credentials, API keys, and tokens, from 1Password or Bitwarden instead of storing it in Crumble.
- [Automations, Messaging, and Integrations](https://docs.crumbli.ng/concepts/schedules-and-integrations): Run automations on a schedule, let bots talk to each other, and connect external tools over MCP.
- [Web Search](https://docs.crumbli.ng/concepts/web-search): Let a bot search the web and read pages with Mixed.
- [Discord](https://docs.crumbli.ng/concepts/discord): Connect Discord to your existing bot chats, restrict access, and choose which bot answers.
- [Event Automations](https://docs.crumbli.ng/concepts/event-automations): Run an automation each time a webhook arrives, through a Doorstep event relay.

## Web app

- [Web App](https://docs.crumbli.ng/clients/web): Find your way around the web app the server serves at /ui.

## Self-hosting

- [Configuration](https://docs.crumbli.ng/self-hosting/configuration): Environment variables for the Crumble server, and what to set before exposing it to a network.
- [Set Up Workspaces](https://docs.crumbli.ng/self-hosting/workspaces): Run bot workspaces on Microsandbox on your own hardware, or on Railway.
- [Back Up and Migrate](https://docs.crumbli.ng/self-hosting/backups): What to back up, and how to move data from a single-user server into an account.

## Reference

- [API Reference](https://docs.crumbli.ng/reference/api): Authenticate, call the /v1 HTTP API, and subscribe to event streams.
- [Glossary](https://docs.crumbli.ng/reference/glossary): The words Crumble uses, and the ones it avoids.

## Contributing

- [Contributing](https://docs.crumbli.ng/contributing): How the server repository is laid out, which checks to run, and how to release.
- [Architecture](https://docs.crumbli.ng/contributing/architecture): How the server is built, from sign-in to storage to workspaces.
- [Message gateway adapters](https://docs.crumbli.ng/contributing/message-gateway-adapters): Add a compiled-in chat adapter without putting platform-specific routing in the gateway.

## Agent skills

- [crumble](https://docs.crumbli.ng/.well-known/agent-skills/crumble/SKILL.md): Read the Crumble docs instead of answering from memory. Self-hosted personal AI bots with persistent memory, continuous chats, and isolated workspaces. Use when a task involves Crumble: how it works, how to set it up or configure it, or its API.

## Agent resources

- [llms-full.txt](https://docs.crumbli.ng/llms-full.txt): The full Markdown of every page in one file.
- [Page Markdown](https://docs.crumbli.ng/index.md): Append `.md` to any page URL to fetch that page as raw Markdown.
- [JSON API](https://docs.crumbli.ng/api/docs/pages.json): Page index of the JSON docs API; each entry links the page's JSON and Markdown forms. Described by the OpenAPI document at https://docs.crumbli.ng/openapi.json.
- [Agent skills](https://docs.crumbli.ng/.well-known/agent-skills/index.json): Agent Skills discovery index of the skills this site publishes.
- [API catalog](https://docs.crumbli.ng/.well-known/api-catalog): RFC 9727 linkset of the APIs documented here.
- [AI catalog](https://docs.crumbli.ng/.well-known/ai-catalog.json): ARD manifest of the agent-facing resources on this site (MCP server, skills, APIs).
- [agent-readability.json](https://docs.crumbli.ng/agent-readability.json): Manifest of every agent-facing artifact on this site.
- [Sitemap](https://docs.crumbli.ng/sitemap.xml): Every indexable page URL with its last-modified date.