# CraftBot

> CraftBot is a personal AI assistant that lives on your machine, autonomously interprets tasks, plans actions, and executes them 24/7 to help you achieve your goals.

CraftBot is an open-source personal AI assistant that runs locally on your machine and works autonomously to help you accomplish complex, multi-step tasks. It learns your preferences, habits, and life goals, then proactively plans and initiates tasks (with your approval) to help you improve. CraftBot supports multiple LLM providers, MCP integrations, and a rich skill framework, making it highly extensible and customizable.

- **Bring Your Own Key (BYOK)** — *Supports OpenAI, Google Gemini, Anthropic Claude, BytePlus, and local Ollama models; switch providers easily via config.*
- **Memory System** — *Distills and consolidates daily events at midnight using RAG-based semantic memory powered by ChromaDB.*
- **Proactive Agent** — *Learns your preferences and life goals, then plans and initiates tasks autonomously (with approval) to help you stay on track.*
- **External Tools Integration** — *Connect to Google Workspace, Slack, Notion, Zoom, LinkedIn, Discord, and Telegram via embedded credentials and OAuth support.*
- **MCP Support** — *Model Context Protocol integration extends agent capabilities with external tools and services.*
- **Extensible Skills Framework** — *Built-in skills for task planning, research, code review, git operations, and more; easily add custom skills.*
- **Multiple Interface Modes** — *Run via Browser (default), TUI, CLI, or experimental GUI mode for desktop automation with visual feedback.*
- **Cross-Platform** — *Full support for Windows and Linux, with Docker containerization for consistent isolated environments.*
- **Background Service** — *Run CraftBot as a background service with auto-start on login and a desktop shortcut for easy browser access.*

To get started, clone the repository, run `python install.py` to install dependencies, then launch with `python run.py`. The first run guides you through API key setup and onboarding. Use `/help` to explore available commands and connect external services like Google, Slack, and Notion.

## Features
- Bring Your Own Key (BYOK) LLM provider support
- RAG-based semantic memory with ChromaDB
- Proactive task planning and initiation
- Google Workspace, Slack, Notion, Zoom, LinkedIn, Discord, Telegram integrations
- Model Context Protocol (MCP) integration
- Extensible skill framework
- Browser, TUI, CLI, and GUI interface modes
- Background service with auto-start
- Docker containerization support
- GUI/screen automation (experimental)
- OAuth and PKCE authentication for external services
- Cross-platform: Windows and Linux

## Integrations
OpenAI, Google Gemini, Anthropic Claude, BytePlus, Ollama, Google Workspace, Slack, Notion, Zoom, LinkedIn, Discord, Telegram, ChromaDB, Docker, Playwright

## Platforms
WINDOWS, MACOS, LINUX, WEB, API, CLI

## Pricing
Open Source

## Version
v1.2.3

## Links
- Website: https://craftos.net/craftbot.html
- Documentation: https://github.com/CraftOS-dev/CraftBot
- Repository: https://github.com/CraftOS-dev/CraftBot
- EveryDev.ai: https://www.everydev.ai/tools/craftbot