Skip to content

CraftBot

CraftBot is a self-hosted AI agent that lives on your machine and works like a remote employee: it plans tasks into steps, executes them with real tools (files, shell, web, and your connected apps), remembers your preferences across sessions, and proactively initiates work it thinks you need, with your approval.

Unlike chat assistants, CraftBot can also build and operate its own software. Ask for a kanban board, a CRM, or a habit tracker and the agent designs, codes, tests, and launches a working web app inside its own interface, then keeps reading and writing that app's data in future tasks. This system is called Living UI.

Everything runs locally and you bring your own model: an API key from any of 13 supported providers, a ChatGPT or SuperGrok subscription, or a free local model through Ollama.

Install

Requirements: Python 3.10+ · Node.js 18+ (browser interface only)

git clone https://github.com/CraftOS-dev/CraftBot.git
cd CraftBot
python craftbot.py install

That single command installs dependencies, registers CraftBot to start at login, launches it in the background, and opens the browser interface at http://localhost:7925. For manual setup, CLI-only mode, conda, and Docker, see Install.

Where to go

I want to... Go to
Get running and send my first task in ~10 minutes Quickstart
Follow a reading track for my experience level Learning path
Understand how the agent works Core
Connect Gmail, Slack, Telegram, GitHub, ... Integrations
Have the agent build me an app Living UI
Follow an end-to-end recipe Guides
Write my own skills, actions, or integrations Develop
Look up an action, setting, or error Reference

What CraftBot does

  • Task execution in modes

    Quick requests run as lightweight simple tasks. Bigger requests become complex tasks with a live todo list and a confirmation step before closing. You never manage sessions. CraftBot routes each message to the right conversation or running task.

    Task modes

  • 1,100+ built-in actions

    File operations, shell, web research, document conversion, image and video generation, plus deep coverage per integration: 107 GitHub actions, 80 Discord, 60 Slack, 99 Stripe, and more.

    Actions catalogue

  • Memory

    Local RAG (vector + keyword search over markdown files) recalls relevant facts mid-task. A nightly process distills the day's events into long-term memory. Nothing leaves your machine except the model calls you configure.

    Memory

  • Proactive agent

    Learns your goals and habits, plans follow-ups, and proposes tasks on its own schedule. It acts only after you approve.

    Proactive mode

  • Integrations

    OAuth or bring-your-own-key connections to Google Workspace, Slack, Discord, Telegram, WhatsApp, Notion, GitHub, Jira, Stripe, HubSpot, and more, plus any MCP server.

    Integrations

  • Skills

    195 bundled skills teach the agent repeatable workflows: PDF generation, web research, code review, day planning. Invoke them with slash commands, install more, or have CraftBot create a skill from a task it just finished.

    Skills

  • Agent profiles

    Import prebuilt personas (CEO agent, finance agent, DevOps engineer, and 40+ others) from the CraftBot Agent Bundles repository with one click. 120 ready-made playbooks cover common automations.

    Agent bundles

  • Two interfaces

    A browser UI for everyday use (chat, live action panel, Living UI tabs, settings) and a CLI for scripting and headless environments. Both run on Windows, macOS, and Linux, foreground or as a background service.

    Interfaces

Project status