Skip to content

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:
  4. Generates observations
  5. Identifies knowledge gaps
  6. Searches multiple sources
  7. Evaluates evidence
  8. Synthesizes findings
  9. 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