Kantin-Petit
be1ad76966
Client /api/chat (modèles cloud via proxy, auth Bearer, timeout, erreurs sans fuite). Boucle comprendre→outil→observer→répondre avec garde-fou anti-boucle, audit par appel et Guard injecté (abstraction prête pour le gatekeeper Phase 2). ToolHandle découplé de MCP. Palier de risque : reversible. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
CHLOVA
Assistant personnel (style Jarvis). Couche d'orchestration au-dessus d'un homelab Debian + Docker + Traefik existant. Le cerveau est un LLM en boucle tool-calling qui agit via des outils MCP (n8n, Portainer) et parle aux modèles Ollama cloud.
Voir
CLAUDE.mdpour l'architecture et les règles non négociables.
État
- Phase 0 — socle (en cours) : structure, sécurité, conventions, compose.
- Phase 1 — cerveau lecture seule : orchestrateur + MCP read-only + texte.
- Phases 2+ : non implémentées (écriture, need-review, voix, auto-extension).
Structure
| Dossier | Rôle |
|---|---|
docs/ |
Architecture, sécurité, versioning, paliers de risque, gabarit d'asset |
infra/ |
docker-compose de la stack + socket-proxy + notes réseau |
orchestrator/ |
Le cerveau (TypeScript/Node, Fastify) |
workflows-n8n/ |
Exports JSON des workflows (le dépôt fait foi) |
Démarrage (dev)
À compléter en fin de Phase 1. Pré-requis : Node 22, Docker. Copier
.env.example → .env, renseigner les secrets (jamais commités).
Sécurité
Seul le backend CHLOVA est exposé. Ollama/n8n/Portainer restent sur le réseau
Docker interne. Secrets via env/coffre uniquement. Voir [docs/security.md].