hockey-chatbot / README.md
talhasideline's picture
Update README.md
2dffde8 verified
---
title: Hockey Mind AI Chatbot
emoji: πŸ’
colorFrom: green
colorTo: blue
sdk: gradio
sdk_version: 4.8.0
app_file: app.py
pinned: false
license: mit
---
# πŸ’ Hockey Mind AI Chatbot
An intelligent field hockey coaching assistant that provides personalized advice, training recommendations, and video content suggestions.
## Features
- **Multilingual Support**: English and Dutch language support
- **Role-Based Coaching**: Tailored responses for coaches, players, and trainers
- **Video Recommendations**: AI-powered content suggestions using FAISS similarity search
- **Domain-Specific**: Focused exclusively on field hockey topics
- **Smart Filtering**: Automatic detection of hockey-related vs out-of-domain queries
## Technology Stack
- **Frontend**: Gradio 4.8.0 for interactive web interface
- **AI Model**: OpenRouter API with GPT-4o for intelligent responses
- **Embeddings**: Sentence Transformers with multilingual support
- **Vector Search**: FAISS for fast similarity search
- **Database**: SQLite with pre-computed embeddings
## Usage
Ask questions about:
- Field hockey training and drills
- Shooting techniques (backhand, forehand, drag flicks)
- Penalty corners and set pieces
- Player positioning and strategies
- Equipment and rules
- Youth coaching (U8, U10, etc.)
## Environment Variables
Required for deployment:
- `OPENROUTER_API_KEY`: Your OpenRouter API key
- `DATABASE_PATH`: Path to the hockey video database (defaults to HockeyFood.db)