.github/README.md

You are reading the Github README!

• 📚 Documentation: See our technical documentation for detailed information
• 📖 Demo README: Check out the Demo README for setup, configuration, and contribution guidelines
• 🏆 Hackathon Submission: Keep reading below for more information about our MCP Hackathon submission

Quick Start

1. Environment Setup

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

# Sync dependencies
uv sync --all-extras

2. Run the UI

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

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

3. 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
• OAuth token is used only for the current session and never stored

4. Connect via MCP

This application exposes a Model Context Protocol (MCP) server, allowing you to use its search tools directly from Claude Desktop or other MCP clients.

MCP Server URL: http://localhost:7860/gradio_api/mcp/

Claude Desktop Configuration: Add this to your claude_desktop_config.json:

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