docs/LOCAL_TESTING.md

# Local Testing Guide for GAIA Agent

This document outlines how to test the GAIA agent locally during development.

## Setup

1. Install dependencies:
   ```bash
   pip install -r requirements.txt
   ```

2. If you want to use the OAuth features locally:
   ```bash
   huggingface-cli login
   ```
   Or set the `HF_TOKEN` environment variable with your token from [HF Settings](https://huggingface.co/settings/tokens).

## Running the Application

### Option 1: Simplified Local Testing (Recommended for Development)

Use `app_local.py` which has a mock agent and doesn't require OAuth:

```bash
python app_local.py
```

Or use the helper script:

```bash
bash run_local.sh
```

This will:
- Install required dependencies
- Run the local version of the app
- Use a mock agent that returns test responses
- Use local sample questions without making API calls
- Not submit any answers to the actual API

### Option 2: Full Application with Test Username

If you want to test the full application but without requiring login:

```bash
python app2.py
```

When the application loads:
1. Enter a test username in the "Or enter test username for local development" field
2. Click "Run Evaluation & Submit All Answers"

### Option 3: Full Application with OAuth

To test the complete application with OAuth authentication:

1. Make sure you're logged in to Hugging Face CLI: `huggingface-cli login`
2. Run: `python app.py` or `python app2.py`
3. Click the "Login" button in the interface
4. After logging in, click "Run Evaluation & Submit All Answers"

## Debugging

If you encounter OAuth-related errors:
1. Check if you're logged in with `huggingface-cli whoami`
2. Try setting your Hugging Face token as an environment variable:
   ```
   export HF_TOKEN=your_token_here
   ```
3. Use the local testing version (`app_local.py`) which avoids OAuth entirely

## Next Steps

1. Replace the mock agent in `app_local.py` with your real agent implementation
2. Test with a small set of sample questions before scaling up
3. Gradually add and test tools (web search, file reader, etc.)
4. When ready, deploy to Hugging Face Spaces for full evaluation