Kantin-Petit
52980837a9
docs/need-review.md (cycle complet : états, sursis, gatekeeper, cron, review, rollback). CHLOVA_PHASE dans .env.example + compose (défaut 1). risk-tiers + README : application par phase. Compose revalidé, 45 tests, 0 vuln. Palier de risque : n/a (doc + config). 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].