CraftBot

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.