Kantin-Petit 6eda8312a6 feat: docker-compose stack CHLOVA (v0.4.0) — fin Phase 0
Stack complète : Ollama (proxy cloud, interne+egress, aucun port),
socket-proxy (endpoints lecture seule), MCP n8n + Portainer (read-only),
backend = seule surface (aucun port publié en P1, Telegram long-polling).
Réseaux internal/egress, images épinglées (digests à confirmer), secrets
par référence. `docker compose config` valide.

Palier de risque : privilégié (déploiement infra) — non déployé, validation
requise avant tout `up`.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-23 01:02:53 +02:00

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.md pour 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].

S
Description
No description provided
Readme 380 KiB
Languages
TypeScript 97.9%
Dockerfile 1.2%
CSS 0.7%
HTML 0.2%