F&B Operations Agentic Assistant - Paris Vibe-a-thon: “Build a One-Person Unicorn” — November 15, 2025
AI Tinkerers - Paris
Hackathon Showcase

F&B Operations Agentic Assistant

Reduce waste and understaffing: autonomous F&B agent predicts attendance from weather/events, automates actions, and explains decisions.

1 member

Core Problem & Market Impact

The hospitality industry loses approximately 30% of potential revenue due to inaccurate demand forecasting. Restaurant managers face a daily dilemma: understaffing leads to lost customers and poor service, while overstaffing results in unnecessary labor costs. Current solutions rely on manual spreadsheet analysis and gut feeling, lacking intelligent prediction capabilities. This affects over 1 million restaurants globally, representing a $200B+ market opportunity.

Target Customer

Independent restaurants, restaurant groups, and hospitality operators who need to optimize staffing and inventory based on external factors (events, weather, historical patterns). Primary users: restaurant managers, F&B directors, and operations teams.

Solution Overview

The F&B Operations Agent is an autonomous AI system that predicts customer demand (covers) and recommends optimal staffing levels by analyzing:

  • Upcoming local events (concerts, sports, festivals)
  • Weather forecasts
  • Historical operational patterns
  • Day-of-week and seasonal trends

The agent provides actionable predictions with confidence scores and contextual reasoning, enabling data-driven operational decisions.

Main Features

  1. Autonomous Context Gathering: Automatically retrieves relevant events and weather data
  2. Semantic Pattern Matching: Uses vector search to find similar historical scenarios
  3. Intelligent Reasoning: LLM-powered analysis generates contextual insights
  4. Actionable Recommendations: Specific staff counts and expected covers
  5. Confidence Scoring: Transparent prediction reliability (typically 85-90%)
  6. Key Factor Analysis: Explains the “why” behind predictions

Demo Flow

  1. User inputs target date via Streamlit interface
  2. Agent retrieves event data (e.g., “Coldplay concert at Stade de France”)
  3. Agent fetches weather forecast (e.g., “Clear sky, 22°C”)
  4. System generates semantic embedding of scenario (Mistral AI)
  5. Vector search finds 3 most similar historical patterns (Qdrant)
  6. LLM analyzes patterns and generates prediction (Mistral AI)
  7. Results displayed: 98 expected covers, 7 staff recommended, 88% confidence
  8. Key factors explained: “Large concert nearby, favorable weather, weekday may dampen surge”

Execution & Functionality

  • Fully functional API: FastAPI backend with 3 endpoints (predict, health, docs)
  • Production-ready architecture: Modular agent system (Analyzer, PatternSearcher, Predictor)
  • Real-time processing: <2s response time end-to-end
  • Error handling: Graceful fallbacks for API failures
  • Interactive interface: Streamlit dashboard for non-technical users

AI & Agents Usage

Multi-Agent Architecture:

  1. Analyzer Agent: Extracts structured features (day, event type, magnitude) using Mistral LLM
  2. Pattern Search Agent: Performs semantic similarity search using Qdrant vector database
  3. Predictor Agent: Generates final predictions with contextual reasoning using Mistral LLM

Mistral AI Usage (2x):

  • Embedding generation (mistral-embed): Converts event descriptions into 1024-dimensional vectors
  • LLM reasoning (mistral-large-latest): Feature extraction and prediction generation with contextual analysis

Autonomous Logic:

  • Agents communicate via structured data formats
  • Each agent has specific responsibilities and failure modes
  • System degrades gracefully (mock data fallback if external APIs fail)

Scalability (One-Person Model)

  • Infrastructure: Serverless-ready FastAPI application
  • Database: Qdrant scales horizontally, supports millions of vectors
  • Cost optimization: In-memory Qdrant for prototyping, cloud deployment ready
  • Deployment: Single command deployment via Docker/Vercel
  • Maintenance: Modular architecture enables independent component updates

Partner Tech Usage

Mistral AI:

  • Primary reasoning engine (2 use cases: embeddings + LLM)
  • Handles semantic understanding and contextual analysis
  • Generates human-readable insights

Qdrant:

  • Vector similarity search for historical pattern matching
  • Stores 10 seed scenarios, scalable to millions
  • Enables sub-second retrieval of relevant patterns

ElevenLabs:

  • Voice synthesis integration (text-to-speech)
  • Generates audio summaries of predictions
  • Code implemented, activated on demand

Technologies Used

Core Stack:

  • FastAPI (API framework)
  • Python 3.13
  • Streamlit (UI framework)
  • Pydantic (data validation)

AI/ML:

  • Mistral AI API (embeddings + LLM)
  • Qdrant vector database
  • ElevenLabs API (voice synthesis)

External Data:

  • PredictHQ API (event data)
  • OpenWeatherMap API (weather forecasts)

Development:

  • python-dotenv (environment management)
  • requests (HTTP client)
  • uvicorn (ASGI server)

Hosting/Orchestration:

  • Local development with hot-reload
  • Docker-ready containerization
  • Vercel/Railway deployment compatible

Failure Modes & Resilience

  • External API failures: Falls back to mock data generation
  • Qdrant unavailability: In-memory mode with automatic seeding
  • Invalid inputs: Comprehensive validation with clear error messages
  • Rate limiting: Graceful degradation with cached responses

Next Steps

  1. Data expansion: Integrate 1000+ historical scenarios across multiple cities
  2. Real-time learning: Continuously update patterns based on actual outcomes
  3. Multi-location support: Scale to restaurant chains with location-specific models
  4. Advanced features: Inventory prediction, dynamic pricing recommendations
  5. Mobile app: Native iOS/Android for on-the-go predictions
  6. Integration ecosystem: Connect with POS systems, scheduling software
  7. Benchmark validation: Partner with restaurants to validate accuracy

Impact Statement

This project demonstrates how AI agents can solve real operational challenges in traditional industries.
Built with hospitality-first thinking (I have restaurant server experience), it bridges the gap between cutting-edge AI technology and practical business needs. The system achieves 88% prediction confidence while remaining explainable and actionable for non-technical operators.

This project was created entirely during the Pioneers AILab hackathon.

No prior code, designs, or work were used.

AI Tinkerers ElevenLabs FastAPI Mistral AI OpenWeatherMap API PredictHQ API Python Qdrant Station F Streamlit

GitHub repository

Summarizing URL...