[User Query + Export Options]  
                            │  
                            ▼  
           ┌─────────────────────────────────┐  
           │    LeadResearcherAgent          │ (Enhanced Orchestrator)  
           │  - Query Analysis & Planning    │  
           │  - LLM-as-Judge Evaluation      │  
           │  - Iterative Strategy Refinement│  
           └─────────────────────────────────┘  
                            │ 1. Analyze & Decompose (with thinking process)  
                            ▼  
       ┌─────────────────────────────────────────┐  
       │         Parallel Sub-Tasks              │  
       │      (Up to 5 concurrent tasks)         │  
       └─────────────────────────────────────────┘  
          │           │           │           │  
          ▼           ▼           ▼           ▼  
    ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐  
    │SubAgent 1│ │SubAgent 2│ │SubAgent 3│ │SubAgent N│ (Specialized Workers)  
    │Multi-loop│ │Multi-loop│ │Multi-loop│ │Multi-loop│  
    │ Search   │ │ Search   │ │ Search   │ │ Search   │  
    └──────────┘ └──────────┘ └──────────┘ └──────────┘  
          │           │           │           │  
          ▼           ▼           ▼           ▼  
       ┌─────────────────────────────────────────┐  
       │     Enhanced Results Aggregation        │  
       │  - Quality Assessment & Confidence      │  
       │  - Source Deduplication & Scoring       │  
       └─────────────────────────────────────────┘  
                            │ 2. Synthesis & LLM-as-Judge Evaluation  
                            ▼  
           ┌─────────────────────────────────┐  
           │    LeadResearcherAgent          │  
           │  - Completeness Assessment      │  
           │  - Gap Identification           │  
           │  - Iterative Refinement         │  
           └─────────────────────────────────┘  
                            │ 3. Generate Final Report  
                            ▼  
           ┌─────────────────────────────────┐  
           │      Enhanced CitationAgent     │ (Post-Processor)  
           │  - Smart Source Descriptions    │  
           │  - Professional Citations       │  
           │  - Quality Assurance            │  
           └─────────────────────────────────┘  
                            │ 4. Export & Delivery  
                            ▼  
              [Final Cited Report + Optional Export]  

# Install uv if you haven't already  
curl -LsSf https://astral.sh/uv/install.sh | sh

# Install the package  
uv add advancedresearch

# Or create a new project with advancedresearch  
uv init my-research-project  
cd my-research-project  
uv add advancedresearch  

# Using pip  
pip install advancedresearch

# Using poetry  
poetry add advancedresearch  

# Clone the repository  
git clone https://github.com/The-Swarm-Corporation/AdvancedResearch.git  
cd AdvancedResearch

# Install with uv (recommended)  
uv sync

# Or with poetry  
poetry install

# Or with pip  
pip install -e .  

# Claude API Key (Primary LLM)  
ANTHROPIC_API_KEY="your_anthropic_api_key_here"

# Exa Search API Key  
EXA_API_KEY="your_exa_api_key_here"

# Optional: OpenAI API Key (alternative LLM)  
OPENAI_API_KEY="your_openai_api_key_here"  

# Install uv (if not already installed)  
curl -LsSf https://astral.sh/uv/install.sh | sh

# Create a new project  
uv init my-research-project  
cd my-research-project

# Add advancedresearch  
uv add advancedresearch

# Create your research script  
cat > research.py << 'EOF'  
from advancedresearch import AdvancedResearch

# Initialize the system  
research_system = AdvancedResearch()

# Run research  
results = research_system.research(  
    "What are the latest developments in quantum computing?",  
    export=True,  
    export_path="quantum_computing_report.md"  
)

print(f"Research completed! Report: {results['research_metadata']['exported_to']}")  
EOF

# Run your research  
uv run research.py  

from advanced_research import AdvancedResearch

# Initialize the system  
research_system = AdvancedResearch(max_iterations=1)

# Run research  
results = research_system.research(  
    "What are the latest developments in quantum computing?",  
    export=True,  
    export_path="quantum_computing_report.md",  
)

print(results)  

# Clone and setup development environment  
git clone https://github.com/The-Swarm-Corporation/AdvancedResearch.git  
cd AdvancedResearch

# Install development dependencies with uv (recommended)  
uv sync --dev

# Run tests  
uv run pytest

# Run linting  
uv run ruff check .  
uv run black --check .

# Run type checking  
uv run mypy advanced_research/

# Format code  
uv run black .  
uv run ruff check --fix .  

@misc{anthropic2024researchsystem,  
    title={How we built our multi-agent research system},  
    author={Anthropic},  
    year={2024},  
    month={June},  
    url={https://www.anthropic.com/engineering/built-multi-agent-research-system}  
}

@software{advancedresearch2024,  
    title={AdvancedResearch: Enhanced Multi-Agent Research System},  
    author={The Swarm Corporation},  
    year={2024},  
    url={https://github.com/The-Swarm-Corporation/AdvancedResearch},  
    note={Implementation based on Anthropic's multi-agent research system paper}  
}

@software{swarms_framework,  
    title={Swarms: An Open-Source Multi-Agent Framework},  
    author={Kye Gomez},  
    year={2023},  
    url={https://github.com/kyegomez/swarms}  
}