Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

11 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

F1 AI Semantic Search Assistant

AI-powered semantic and hybrid retrieval system for Formula 1 race intelligence using real F1 race data, vector embeddings, and metadata-aware search.

Built using:

  • FastAPI
  • Ollama
  • ChromaDB
  • FastF1
  • Local Embedding Models
  • Vector Search

This project demonstrates:

  • embeddings
  • vector databases
  • semantic search
  • metadata filtering
  • hybrid retrieval
  • retrieval pipelines
  • AI backend architecture

Features

  • Local embedding generation using Ollama
  • Persistent vector storage using ChromaDB
  • Semantic similarity search
  • Metadata-based filtering
  • Hybrid retrieval architecture
  • Automated FastF1 race ingestion pipeline
  • Real F1 race results from 2020+
  • Structured + semantic retrieval
  • FastAPI backend APIs
  • Swagger API documentation
  • F1-themed retrieval dataset
  • AI-powered natural language question answering
  • analytics pipelines
  • Query routing and orchestration

Tech Stack

Component Technology
Backend API FastAPI
Embedding Model all-minilm (Ollama)
Vector Database ChromaDB
Local Model Runtime Ollama
F1 Data Source FastF1
Data Processing Pandas
Language Python 3.12

Project Structure

f1-ai-assistant/
│
├── app/
│   ├── main.py
│   │
│   ├── routes/
│   │   └── search_routes.py
│   │
│   ├── services/
│   │   ├── embedding_service.py
│   │   ├── chroma_service.py
│   │   └── search_service.py
│   │
│   ├── ingestion/
│   │   └── race_ingestor.py
│   │
│   ├── data/
│   │   └── sample_races.py
│   │
│   └── db/
│       └── chroma_db/
│
├── venv/
├── requirements.txt
└── README.md

Local Setup

1. Clone Repository

git clone <your-repo-url>
cd f1-ai-assistant

2. Install Python

Recommended:

  • Python 3.12+

Check version:

python3 --version

3. Create Virtual Environment

python3.12 -m venv venv

Activate:

source venv/bin/activate

4. Install Dependencies

pip install -r requirements.txt

OR manually:

pip install fastapi uvicorn chromadb ollama pydantic
pip install celery redis

Ollama Setup

Install Ollama

Official website:

https://ollama.com

OR using Homebrew:

brew install ollama

Start Ollama

ollama serve

Keep this terminal running.


Pull Embedding Model

ollama pull all-minilm
ollama pull llama3.2

Run Application

Start FastAPI server:

uvicorn app.main:app --reload

Application runs at:

http://127.0.0.1:8000

Start Redis

brew services start redis

Start Celery server:

celery -A app.tasks worker --loglevel=info
# celery -A app.celery_app.celery worker \
# --pool=solo \
# --loglevel=info

Swagger API Docs

FastAPI automatically generates API docs:

http://127.0.0.1:8000/docs

API Endpoints

Ingest Sample Data

POST /ingest

Generates embeddings and stores F1 race data into ChromaDB.


Semantic Search

GET /search

Example:

/search?query=Ferrari strategy mistakes

Returns semantically similar race documents.


Debug Stored Data

GET /debug/all

Returns all stored documents from ChromaDB.


Ask Questions (AI Query Engine)

GET /ask

Natural language Formula 1 question-answering API.

This endpoint:

  • classifies the query
  • routes between retrieval and analytics pipelines
  • performs semantic search using embeddings
  • applies metadata filtering
  • generates human-readable AI responses

How Semantic Search Works

  1. Race documents are converted into embeddings
  2. Embeddings are stored in ChromaDB
  3. User query is converted into embedding
  4. ChromaDB performs nearest-neighbor vector search
  5. Most semantically similar documents are returned

Example Query

Input:

Ferrari strategy mistakes

Possible Result:

Ferrari lost Monaco GP due to poor pit strategy and tire timing.

Even though exact keywords differ.


Future Improvements

  • Add metadata filtering
  • Add RAG workflow
  • Add local LLM responses
  • Add race ingestion pipeline
  • Add frontend UI
  • Add hybrid search
  • Add reranking

Key AI Concepts Demonstrated

  • Embeddings
  • Vector Databases
  • Semantic Search
  • Similarity Search
  • Retrieval Systems
  • RAG Foundations
  • AI Backend Architecture
  • Query routing
  • Semantic retrieval
  • Hybrid AI pipelines
  • Metadata filtering
  • LLM-powered query parsing
  • Analytics orchestration
  • Natural language response generation
  • Vector similarity search

Notes

  • ChromaDB is configured with persistent local storage
  • Embeddings are generated locally using Ollama
  • No paid API usage required
  • Optimized for Apple Silicon Macs

Useful Links


License

MIT

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages