This Python framework emulates Grok's "heavy" mode by orchestrating multiple specialized AI agents to provide comprehensive, multi-perspective analysis. It's designed for users seeking in-depth insights and complex problem-solving capabilities, offering a more thorough understanding than single-agent systems.

How It Works

The system leverages a multi-agent architecture, running up to four specialized agents in parallel. An orchestrator first generates tailored research questions from the user's query, then distributes these to individual agents. These agents execute concurrently, utilizing a suite of auto-discovered tools (web search, calculator, file operations). Finally, a synthesis agent combines the outputs from all parallel agents into a unified, comprehensive answer, mimicking Grok's deep analysis.

Quick Start & Requirements

• Install: Clone the repository, create and activate a virtual environment using uv, and install dependencies with uv pip install -r requirements.txt.
• Configuration: Edit config.yaml to add your OpenRouter API key.
• Prerequisites: Python 3.8+, uv (recommended).
• Usage: Run single-agent mode with uv run main.py or multi-agent "Grok heavy" mode with uv run make_it_heavy.py.

Highlighted Details

• Emulates Grok's "heavy" mode with parallel agent execution.
• Features dynamic question generation tailored to user queries.
• Supports hot-swappable tools via automatic discovery from a tools/ directory.
• Provides real-time visual feedback on agent progress.

Maintenance & Community

The project is maintained by Doriandarko. Contributions are welcome via pull requests.

Licensing & Compatibility

MIT License with a commercial attribution requirement for products exceeding 100K users, requiring attribution to Pietro Schirano and the "Make It heavy" framework.

Limitations & Caveats

The framework's performance and capabilities are dependent on the underlying OpenRouter models and API access. The "Grok heavy" emulation is a functional approximation. The attribution requirement may impact commercial adoption for large-scale products.