clean up the openf1 tab

README.md

@@ -9,7 +9,10 @@ app_file: app.py
 pinned: true
 license: apache-2.0
 short_description: 'Historical & real-time F1 data and strategy'
-tag: 'mcp-server-track'
+video_url: TBD
+tags:
+  - 'mcp-server-track'
+  - 'agent-demo-track'
 ---
 
 
@@ -19,9 +22,9 @@ The MCP server is defined inside `app.py` and is hosted on HuggingFace spaces us
 
 ## MCP Client
 
-The MCP client is defined inside `mcp_client.py` and allows interaction with the MCP server through server side events (SSE) transport.
+The MCP client and AI agent is defined inside `mcp_client.py` and allows interaction with the MCP server through server side events (SSE) transport.
 
-For MCP clients that support SSE transport (Not Claude Desktop, see below for info), the following configuration can be used:
+For MCP clients that support SSE transport (for Claude Desktop, see below), the following configuration can be used:
 
 ```json
 {

mcp_client.py

@@ -2,10 +2,15 @@ import os
 import gradio as gr
 from typing import List, Dict
 from smolagents import InferenceClientModel, LiteLLMModel, ToolCallingAgent, MCPClient
+import datetime
+
+time = datetime.datetime.now().astimezone().isoformat()
 
 SYSTEM_PROMPT = """You are a helpful Formula 1 assistant and strategist. You have access to various F1 data and tools to help answer questions about races, drivers, teams, and more. 
 Be concise and accurate in your responses. If you don't know something, use the available tools to find the information.
-In addition, you will be asked to act as a live race engineer strategist during a Formula 1 race, making crucial calls during the event."""
+In addition, you will be asked to act as a live race engineer strategist during a Formula 1 race, making crucial calls during the event.
+
+Current time (ISO 8601): {time}"""
 
 
 def agent_chat(message: str, history: list):

openf1_registry.py

@@ -2,6 +2,21 @@ from enum import Enum
 from dataclasses import dataclass
 from typing import Dict, Set, List, Optional
 
+api_endpoints = {
+    "sessions": "sessions?",
+    "weather": "weather?",
+    "locations": "locations?",
+    "drivers": "drivers?",
+    "intervals": "intervals?",
+    "laps": "laps?",
+    "car_data": "car_data?",
+    "pit": "pit?",
+    "position": "position?",
+    "race_control": "race_control?",
+    "stints": "stints?",
+    "team_radio": "team_radio?",
+}
+
 class FilterType(Enum):
     EQUALITY = "equality"       # exact match
     COMPARISON = "comparison"   # >, <, >=, <=

openf1_tools.py

@@ -1,25 +1,17 @@
 import json
 from urllib.request import urlopen
-from openf1_registry import f1_api
+from openf1_registry import f1_api, api_endpoints
 
 
-api_endpoints = {
-    "sessions": "sessions?",
-    "weather": "weather?",
-    "locations": "locations?",
-    "drivers": "drivers?",
-    "intervals": "intervals?",
-    "laps": "laps?",
-    "car_data": "car_data?",
-    "pit": "pit?",
-    "position": "position?",
-    "race_control": "race_control?",
-    "stints": "stints?",
-    "team_radio": "team_radio?",
-}
+### Essential tools ###
 
+def get_current_time() -> str:
+    """
+    Retrieve the current time in ISO 8601 format.
 
-### Essential tools ###
+    Returns:
+        str: The current time in ISO 8601 format.
+    """
 
 def get_api_endpoint(endpoint: str) -> dict:
     """

todo.txt

@@ -0,0 +1,12 @@
+- host agent using Modal labs
+- Add some more documentation
+- Record demonstration using Loom and add link to README
+    * Demo the Gradio UI
+    * Demo the MCP client using Claude Desktop
+    * Demo the MCP client using mcp_client.py
+
+More info about the Gradio agent: https://www.gradio.app/guides/agents-and-tool-usage 
+
+Side sponsor wins
+- Modal labs choice (host a LLM on their platform using vLLM or ollama)
+- Mistral AI choice (If using a large model, perhaps pick a Mistral one, Nebius offers a ~270B model from their API)

utils/constants.py

@@ -104,10 +104,10 @@ For Claude Desktop, the following configuration can instead be used, but make su
 OPENF1_TOOL_DESCRIPTION = """
 ## OpenF1 Tools - API Endpoints.
 
-This UI Interface/Tab collects all the MCP tools that are based on the `OpenF1` API, which are a bit more advanced compared to the other UI tabs that are implemented using the FastF1 library.
-In essence, the tools listed below make it possible to access the `OpenF1` API directly within the MCP server, thus allowing a LLM to interact with the `OpenF1` API.
-The **_OpenF1_** API exposes several **_endpoints_** that can be used to access different types of real-time and historical data about Formula 1 races, drivers, and teams.
-Each of these endpoints have different **_filters_** that can be used to filter the data returned by the endpoint. The data passed and returned is entirely in JSON format.
+This UI Interface/Tab collects all the MCP tools that are based on the `OpenF1` API, which are a bit less user friendly compared to the tools in the other tabs, which are implemented using the `FastF1` library.
+In essence, the tools listed below make it possible to access the `OpenF1` API directly within the MCP server, thus allowing a LLM to interact with the `OpenF1` API using natural language.
+The API exposes several **_endpoints_** that can be used to access different types of real-time and historical data about Formula 1 races, sessions, drivers, and constructor teams.
+Each of these endpoints have different **_filters_** that can be used to specify the data returned from the endpoint. The data communication is entirely in JSON format making it optimized for the LLM.
 
 The implemented functions make it possible to:
 - Get all available endpoints - `get_api_endpoints()`
@@ -122,16 +122,22 @@ The implemented functions make it possible to:
 
 MARKDOWN_OPENF1_EXAMPLES = """
 
+' Retrieve data about car number 55 with session_key 9159 where the speed was greater than 315 '
 ```https://api.openf1.org/v1/car_data?driver_number=55&session_key=9159&speed>=315```
 
+' Retrieve data about driver number 1 with session_key 9158 '
 ```https://api.openf1.org/v1/drivers?driver_number=1&session_key=9158```
 
+' Retrieve data about intervals with session_key 9165 where the interval was less than 0.005s'
 ```https://api.openf1.org/v1/intervals?session_key=9165&interval<0.005```
 
+' Retrieve data about laps with session_key 9161 for driver number 63 on lap number 8'
 ```https://api.openf1.org/v1/laps?session_key=9161&driver_number=63&lap_number=8```
 
+' Retrieve data about meetings in 2023 for Singapore'
 ```https://api.openf1.org/v1/meetings?year=2023&country_name=Singapore```
 
+' Retrieve data about pit stops with session_key 9158 where the pit duration was less than 31s'
 ```https://api.openf1.org/v1/pit?session_key=9158&pit_duration<31```
 
 """