README.md

metadata

title: The Padelito Coach 🎾
emoji: 🎾
colorFrom: yellow
colorTo: green
sdk: gradio
sdk_version: 5.42.0
app_file: app.py
tags:
  - mcp-server-track
  - agent-demo-track
pinned: false
license: mit
short_description: 🎾 World's first AI padel booking & advisor

The Padelito Coach

🎾 World's first AI padel booking, padel management and advisor app

Overview

The Padelito Coach is the world's first AI-powered padel booking and management system. This intelligent application combines advanced AI capabilities with user-friendly interfaces to revolutionize how padel players book courts, manage their games, and receive coaching advice.

Features

• Court Booking: Book padel courts with natural language commands
• Booking Management: Add, remove, and modify court reservations
• Schedule Tracking: View and manage your court booking agenda
• AI Coach: Get personalized padel coaching advice and tips
• Intelligent Assistant: Natural language processing for easy interaction
• Memory System: Persistent storage of bookings and preferences
• MCP Integration: Full Model Context Protocol support for AI client integration

Installation

Prerequisites

• Python 3.13+
• UV package manager or pip
• API keys for AI services (Mistral, OpenAI, Google Gemini, etc.)

Setup

1. Create and activate virtual environment:

uv venv --python 3.13
source .venv/bin/activate

2. Install dependencies:

uv pip install -r requirements.txt

3. Configure environment variables:

source .env

Required API keys:

• MISTRAL_API_KEY: Mistral API for AI processing
• OPENAI_API_KEY: OpenAI API for language processing (optional)
• GOOGLE_API_KEY: Google Gemini API (optional)
• HF_API_KEY: HuggingFace API (optional)
• COHERE_API_KEY: Cohere API for embeddings (optional)

Usage

Start The Padelito Coach

python app.py

This launches a comprehensive Gradio web interface with the following padel management tools:

Court Booking Management:

• Add to Cellar: Book padel courts with natural language (e.g., "book court 3 at 12h tomorrow")
• Remove from Cellar: Cancel or modify existing bookings
• Cellar Inventory: View your current court booking schedule
• Cellar Reset: Clear all bookings and start fresh

Key Features:

• Natural language booking: "book court 3 at 12h tomorrow, jean john bob jeanne"
• Intelligent scheduling: Maximum 4 courts, 1.5-hour sessions, 9 AM to 9 PM
• Party management: Tracks 4-player requirements per booking
• Persistent storage: All bookings saved to local database

Example Commands

book court 3 at 12h tomorrow, jean john bob jeanne
book court 1 at 2 PM today for 4 players
remove the booking court 3 at 12h
cancel my 2 PM booking today
what is the court booking agenda?
show me all my bookings
what courts are available tomorrow?
book court 2 for 4 PM with maria, carlos, ana, pedro

MCP Integration

This project includes an MCP (Model Context Protocol) server for integration with AI clients.

MCP Server URL: https://agents-mcp-hackathon-ThePadelito.hf.space/gradio_api/mcp/sse

SSE Integration

For clients that support SSE (e.g., Cursor, Windsurf, Cline), add this configuration:

{
  "mcpServers": {
    "the-padelito-coach": {
      "url": "https://agents-mcp-hackathon-ThePadelito.hf.space/gradio_api/mcp/sse"
    }
  }
}

Stdio Integration

For clients that only support stdio (such as Claude Desktop):

1. First install Node.js from https://nodejs.org/
2. Add this configuration:

{
  "mcpServers": {
    "the-padelito-coach": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://agents-mcp-hackathon-ThePadelito.hf.space/gradio_api/mcp/sse",
        "--transport",
        "sse-only"
      ]
    }
  }
}

Architecture

Core Components

• app.py: Main Gradio interface with padel booking management tools
• TWS_fonctions.py: Core padel booking functions and AI integrations
• printdb.py: Database utility for viewing stored booking data
• tmp/: Local database storage directory for bookings and session data
• requirements.txt: Python dependencies
• gradio.css: Custom styling for the web interface

AI Integration

The system integrates with multiple AI providers for intelligent booking management:

• Mistral AI: Primary natural language processing for booking commands
• OpenAI: Alternative language model support
• Google Gemini: Additional AI capabilities
• HuggingFace: Open-source model integration
• Cohere: Embeddings and reranking
• Agno Framework: AI agent orchestration and memory management

License

See LICENSE file for details.