Meet CraftBot: Your Ultimate 24/7 Personal AI Desktop Assistant

In the rapidly evolving landscape of artificial intelligence, having a smart assistant isn't just a luxury anymore—it's a necessity for scaling productivity. But what if your AI assistant didn't just live in a web tab? What if it lived directly on your machine, working tirelessly 24/7 to interpret tasks, plan actions, and execute them autonomously? Enter CraftBot, an open-source, highly versatile personal AI assistant.

Whether you're looking to automate mundane daily workflows, manage complex scheduling, or integrate deeply with your favorite workspace tools, CraftBot is built to handle it all. Let's dive deep into what makes CraftBot the ultimate productivity companion and how you can set it up on your own system.

What is CraftBot?

Hosted on GitHub, CraftBot is a locally hosted, proactive AI assistant designed to live inside your machine. Unlike standard chatbots that wait for your prompts, CraftBot is designed with a proactive architecture. It learns your preferences, habits, and life goals over time. With your approval, it can initiate tasks, plan workflows, and help you reach your objectives seamlessly.

Standout Features of CraftBot

CraftBot is packed with advanced capabilities tailored for power users, developers, and productivity enthusiasts:

• Bring Your Own Key (BYOK): Flexibility is at the core of CraftBot. It supports multiple LLM providers, including OpenAI, Google Gemini, Anthropic Claude, BytePlus, and even local Ollama models. You can easily switch between providers based on your budget and processing needs.
• Advanced Memory System: CraftBot utilizes a RAG-based semantic memory system powered by ChromaDB. At midnight, it distills and consolidates the events of the day, ensuring it remembers crucial context for future interactions.
• Proactive Agent Capabilities: It doesn't just react; it acts. By understanding your long-term goals, it can formulate plans and propose task initiations to keep you on track.
• Extensive External Integrations: CraftBot seamlessly connects with your existing tech stack. It supports embedded credentials and OAuth for tools like Google Workspace, Slack, Notion, Zoom, LinkedIn, Discord, and Telegram.
• Model Context Protocol (MCP) & Skills: Extend your agent's capabilities effortlessly. The MCP adapter converts external tools into native actions, while the extensible skill framework handles task planning, research, code reviews, and Git operations.
• Cross-Platform Support: Whether you are on Windows or Linux, CraftBot provides platform-specific code variants and Docker containerization for a smooth experience.

How the Architecture Works

Understanding the under-the-hood mechanics of CraftBot highlights why it's so powerful:

• Agent Base & LLM Interface: The core orchestration layer coordinates the main agentic loop, talking to your chosen LLM via a unified interface.
• Context Engine & Action Router: It generates optimized prompts using KV-cache support and intelligently routes tasks to the best matching action libraries.
• Memory & State Managers: Tracking your global state, execution context, and conversation history, ensuring the AI never loses the thread of a multi-step workflow.
• GUI Module (Experimental): For ultimate desktop automation, CraftBot features a GUI module using OmniParser to physically detect UI elements on your screen and interact with them.

Getting Started: Quick Installation Guide

Setting up your own CraftBot is straightforward. Before you begin, ensure you have Python 3.10+, Git, and an API key from your preferred LLM provider. Node.js 18+ is recommended if you want the sleek browser interface.

# Clone the repository
git clone https://github.com/zfoong/CraftBot.git
cd CraftBot

# Install dependencies
python install.py

# Run the agent
python run.py

Upon your first run, the system will intuitively guide you through inputting your API keys. From there, you can start speaking to the agent naturally, ask it to perform complex tasks, or type /help to see available commands.

Choose Your Interface Mode

CraftBot adapts to how you like to work:

1. Browser Mode: (Default) A modern, highly intuitive web interface.
2. TUI Mode: A robust Terminal User Interface requiring zero extra dependencies. Run via python run.py --tui.
3. CLI Mode: A lightweight command-line interface. Run via python run.py --cli.
4. GUI Mode: Enables visual screen automation (requires additional setup).

Pro Tip: Run CraftBot as a background service using python service.py install so it stays active even when your terminal is closed!

Ready to Supercharge Your Productivity?

If you're tired of doing repetitive digital chores and want a personalized, deeply integrated AI system that truly understands your workflow, CraftBot is the open-source solution you've been waiting for.

Take control of your digital life today by setting up your own 24/7 autonomous AI desktop agent.