GitHub – SureScaleAI/cleverbee: CleverBee – The Open Source Deep Researcher Tool

Website •
Documentation •
GitHub

CleverBee is a powerful Python-based research agent using Large Language Models (LLMs) like Claude and Gemini, Playwright for web browsing, and Chainlit for an interactive UI. It performs research by browsing the web, extracting content (HTML), cleaning it, and summarizing findings based on user research topics.

• 🌐 Interactive web UI via Chainlit
• 🔧 MCP Tool Support: Integrates external tools via the Model Context Protocol (MCP)
• 🧠 Multi-LLM Research: Uses distinct, configurable LLMs for different tasks:
  • Primary LLM: Gemini 2.5 Pro for planning and final report generation
  • Next Step LLM: Gemini 2.5 Flash for analyzing research progress and deciding next actions
  • Summarizer LLM: Gemini 2.0 Flash for intermediate web content summarization
• 🌍 Automated Web Browsing: Utilizes Playwright for searching the web and extracting HTML content
• 📊 Content Processing: Cleans HTML to Markdown before summarization
• 📈 Integrated Token Tracking: Monitors token usage and estimates costs for LLM calls
• ⚙️ Highly Configurable: Settings managed via config.yaml
• 🚀 Modular LLM Clients: Supports different providers (Gemini, Claude, Local GGUF via llama-cpp-python)
• 💾 LLM Caching: Employs NormalizingCache (SQLite-based) for improved performance and cost reduction

• macOS: Fully tested and supported, including both Intel and Apple Silicon (via Rosetta 2)
• Linux: Fully supported, with NVIDIA GPU detection and optimization for local models
• Windows: Limited support via Windows Subsystem for Linux (WSL)

# Clone the repository
git clone https://github.com/SureScaleAI/cleverbee.git
cd cleverbee

# Run the setup script
bash setup.sh

# Start the application
bash run.sh

For full documentation, visit our website: https://cleverb.ee/docs

All major configuration is handled in config.yaml. See the documentation for detailed configuration options.

This project is licensed under the GNU Affero General Public License, Version 3.0. See the LICENSE file for the full text.

By contributing to this project, you agree that your contributions will be licensed under its AGPLv3 license, and you grant a copyright license to your contributions according to the terms of the Contributor License Agreement (CLA).

Keep your files stored safely and securely with the SanDisk 2TB Extreme Portable SSD. With over 69,505 ratings and an impressive 4.6 out of 5 stars, this product has been purchased over 8K+ times in the past month. At only $129.99, this Amazon’s Choice product is a must-have for secure file storage.

Help keep private content private with the included password protection featuring 256-bit AES hardware encryption. Order now for just $129.99 on Amazon!

Help Power Techcratic’s Future – Scan To Support

If Techcratic’s content and insights have helped you, consider giving back by supporting the platform with crypto. Every contribution makes a difference, whether it’s for high-quality content, server maintenance, or future updates. Techcratic is constantly evolving, and your support helps drive that progress.

As a solo operator who wears all the hats, creating content, managing the tech, and running the site, your support allows me to stay focused on delivering valuable resources. Your support keeps everything running smoothly and enables me to continue creating the content you love. I’m deeply grateful for your support, it truly means the world to me! Thank you!