Clément Bourgeois

Agent Sommelier repose sur une architecture RAG orientée goût. Les bouteilles, les notes de dégustation et les profils utilisateurs sont projetés dans un même espace vectoriel avec Voyage AI, puis stockés dans PostgreSQL avec pgvector. Le système peut ainsi effectuer une recherche sémantique directement au plus près des données métier.

La fonctionnalité signature est l'accord multi-convives : le plat et les profils des invités sont combinés pour rechercher des bouteilles candidates, puis un LLM les reclasse en recommandations justifiées. Le système distingue volontairement les recommandations contraintes par catalogue des suggestions ouvertes, afin de maîtriser la différence entre retrieval contrôlé et génération libre.

Côté ingénierie, le produit tourne en production avec un backend FastAPI, un frontend Next.js, Redis pour les workers, PostgreSQL 16, Docker Compose, Traefik et Cloudflare Tunnel sur Raspberry Pi 5. Le projet intègre aussi une observabilité des coûts LLM, des permissions granulaires, du rate limiting, des tests Playwright et un workflow de développement assisté par agents IA.

Agent Voyage repose sur une architecture découplée : un frontend Next.js 14 (App Router) en React et TypeScript, et un backend FastAPI asynchrone en Python 3.12. La persistance s'appuie sur PostgreSQL 16 avec SQLAlchemy 2.0 et des migrations Alembic, la validation des données passant par Pydantic v2.

L'authentification est gérée maison via des jetons JWT (python-jose) et des mots de passe hachés en bcrypt. La réorganisation de l'itinéraire se fait en drag & drop (dnd-kit) et les lieux sont affichés sur Google Maps. Des interfaces abstraites sont prévues pour brancher plus tard des connecteurs externes et des LLM.

Côté infrastructure, tout est conteneurisé avec Docker Compose (frontend, backend, PostgreSQL) et auto-hébergé sur Raspberry Pi. Traefik assure le reverse proxy et le routage par labels, Cloudflare Tunnel expose le site en HTTPS sans ouvrir le moindre port — avec des réseaux Docker séparés pour isoler la base, des healthchecks, du rate-limiting et des secure-headers.

Agent Recette repose sur une architecture découplée : un frontend Next.js 14 (App Router) en React et TypeScript, un backend FastAPI asynchrone, une base PostgreSQL 16 dédiée avec SQLAlchemy 2.0 et migrations Alembic, et un worker de transcription séparé. L'authentification est gérée maison via des jetons JWT et des mots de passe hachés en bcrypt.

Les sources sont traitées comme des connecteurs branchés autour d'un cœur commun : la recette structurée. L'import web exploite le balisage schema.org/Recipe avec un repli sur Claude ; l'import vidéo enchaîne la description, un éventuel lien-recette et les sous-titres (via yt-dlp) puis, en dernier recours, transcrit le son de la vidéo avec Whisper en local (VAD dans un worker dédié). Le tout est structuré par Claude, avec une règle stricte : ne jamais inventer de quantité.

Côté infrastructure, tout est conteneurisé avec Docker Compose (frontend, backend, PostgreSQL dédié, transcriber) et auto-hébergé sur Raspberry Pi. Traefik assure le reverse proxy et le routage par labels, Cloudflare Tunnel expose le site en HTTPS sans ouvrir le moindre port, avec des réseaux Docker séparés pour isoler la base de données.