small fixes, new read.me and better requirements notes

README.md

@@ -12,4 +12,37 @@ hf_oauth: true
 hf_oauth_expiration_minutes: 480
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# GAIA Agent Evaluation Runner
+
+Small Gradio app for the Hugging Face Agents Course final assignment.
+
+The app logs in with Hugging Face OAuth, downloads the GAIA evaluation questions, runs a `smolagents` agent on each question, and submits the answers to the scoring endpoint.
+
+## Setup
+
+Create a `.env` file with the secrets needed by the model provider and by Hugging Face Spaces:
+
+```bash
+HF_TOKEN=your_token_here
+SPACE_ID=your-username/your-space-name
+```
+
+Install the dependencies:
+
+```bash
+python3 -m venv .venv
+source .venv/bin/activate
+pip install -r requirements.txt
+```
+
+Run locally:
+
+```bash
+python app.py
+```
+
+## Notes
+
+- The app uses `https://agents-course-unit4-scoring.hf.space` as the scoring API.
+- The Gradio SDK version is pinned in this README frontmatter and dependencies are pinned in `requirements.txt`.
+- OAuth must be enabled on the Hugging Face Space for the login flow to work.

app.py

@@ -124,7 +124,7 @@ class BasicAgent:
                 VisitWebpageTool(),
                 self.file_tool,
             ],
-            max_steps=10,
+            max_steps=15,
             verbosity_level=0,
             additional_authorized_imports=[
                 "json",

requirements.txt

@@ -1,6 +1,7 @@
-gradio
-requests
-smolagents[openai]
-ddgs
-wikipedia-api
-python-dotenv
+gradio==5.25.2
+requests==2.32.5
+pandas==2.3.3
+smolagents[openai]==1.24.0
+ddgs==9.14.0
+wikipedia-api==0.10.2
+python-dotenv==1.2.2