AI Surveillance & FinOps Engine

Automated AI Watcher CLI Wrapper

Application CLI Python industrielle pour l'automatisation de la veille technologique IA, l'analyse d'impact stratégique et le suivi FinOps des requêtes LLM (40+ modèles gérés).

Python 3.10+ Strict Ingestion Multi-Sources Calculateur FinOps Multi-LLM Tenacity Backoff & Demo Mode Cache SHA-256 TTL Docker Multi-Stage Non-Root
Problématique & Valeur Métier

Les 4 Piliers de Veille & FinOps

Comment structurer l’ingestion de contenu hétérogène et maîtriser les coûts LLM

📥

1. Ingestion Multi-Sources Auto-Détectée

Détection automatique intelligente ou flags explicites (-t, -f, -u) pour ingérer du Texte brut, des Fichiers locaux (.txt, .md) et des URLs Web (scraping BeautifulSoup4).

💰

2. Moteur FinOps & Métriques Token

Calcul précis des coûts en micro-cents USD sur 40+ LLMs (GPT-4o, Claude 3.5 Sonnet, Gemini 1.5 Pro, Llama 3) avec mesure du débit (tokens/seconde) et du temps d'exécution.

🛡️

3. Transport Résilient & Cache SHA-256

Gestion de la tolérance aux pannes via décorateur Tenacity (backoff exponentiel), mode --demo hors-ligne immédiat et cache JSON local indexé par empreinte SHA-256 avec TTL configurable.

📊

4. Moteur Multi-Export

Formatage Console Rich UI couleur, export Markdown (-o report.md) et JSON Pydantic V2 brut (-o json) pour l'intégration dans des pipelines automatisés.

Spécifications Techniques

Architecture Modulaire & Flags CLI

Invariants stricts, typage Pydantic V2 et zéro crash non intercepté (Policy WatcherError)

Flag CLI Alias Description & Rôle Valeur par défaut
source Positionnel Source à analyser (String texte, chemin fichier local, ou URL web http/https) Obligatoire
--text -t Force l'interprétation de la source comme texte brut False
--file -f Force l'interprétation comme chemin de fichier local False
--url -u Force le scraping d'une URL web (BeautifulSoup4) False
--output -o Destination d'export : console (Rich UI), json (stdout), ou fichier (.md, .json) console
--demo -d Exécute en mode hors-ligne avec simulation de réponse LLM (sans API Key) False
--cache-ttl - Durée de vie du cache en secondes (0 désactive la lecture cache) 3600
--no-cache - Bypasse la lecture et l'écriture dans le cache SHA-256 local False
⚠️
Environnement de Démonstration (Simulateur Mock Côté Client) : Cet émulateur terminal est une simulation côté client (Mock CLI Emulator) reproduisant la Rich UI Typer et le moteur FinOps. Aucun processus CLI ni appel API en production n'est lancé sur ce site statique.
bash — ai-watcher scan (Python 3.10 venv)
Scénarios préconfigurés :
$
Prompt Tokens
142
Completion Tokens
310
Débit (Tokens / sec)
452.1 t/s
Coût Est. USD
$0.000483