# Installation Instructions

## Issue: MCP Dependency Conflict

Some dependencies (particularly `spaces` from Gradio) try to downgrade `mcp` to version 1.10.1, which conflicts with `fastmcp` that requires `mcp>=1.17.0`.

## Solution

Use the constraints file when installing dependencies:

```bash
pip install -r pre-requirements.txt
pip install -c constraints.txt -r requirements.txt
```

The `-c constraints.txt` flag enforces the mcp version and prevents downgrades.

## For Hugging Face Spaces

If deploying to Hugging Face Spaces, ensure the installation command uses constraints:
```bash
pip install -c constraints.txt -r requirements.txt
```