docs/overview/quick-start.md

Quick Start

Get started with DeepCritical in minutes.

Installation

# Install uv if you haven't already
pip install uv

# Sync dependencies
uv sync

Run the UI

# Start the Gradio app
uv run gradio run src/app.py

Open your browser to http://localhost:7860.

Basic Usage

1. Authentication (Optional)

HuggingFace OAuth Login:

• Click the "Sign in with HuggingFace" button at the top of the app
• Your HuggingFace API token will be automatically used for AI inference
• No need to manually enter API keys when logged in

Manual API Key (BYOK):

• Provide your own API key in the Settings accordion
• Supports HuggingFace, OpenAI, or Anthropic API keys
• Manual keys take priority over OAuth tokens

2. Start a Research Query

1. Enter your research question in the chat interface
2. Click "Submit" or press Enter
3. Watch the real-time progress as the system:
   • Generates observations
   • Identifies knowledge gaps
   • Searches multiple sources
   • Evaluates evidence
   • Synthesizes findings
4. Review the final research report

3. MCP Integration (Optional)

Connect DeepCritical to Claude Desktop:

1. Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "deepcritical": {
      "url": "http://localhost:7860/gradio_api/mcp/"
    }
  }
}

2. Restart Claude Desktop
3. Use DeepCritical tools directly from Claude Desktop

Available Tools

• search_pubmed: Search peer-reviewed biomedical literature
• search_clinical_trials: Search ClinicalTrials.gov
• search_biorxiv: Search bioRxiv/medRxiv preprints
• search_all: Search all sources simultaneously
• analyze_hypothesis: Secure statistical analysis using Modal sandboxes

Next Steps

• Read the Installation Guide for detailed setup
• Learn about Configuration
• Explore the Architecture
• Check out Examples