Kantin-Petit 0f63b3addd feat: socle sécurité — socket-proxy, réseaux, egress (v0.3.0)
Modèle de menace centré prompt-injection + défenses par couche
(surface réduite, socket-proxy obligatoire, scoping tokens, egress
ollama.com only, secrets par référence, lecture seule renforcée, audit).
Documente réseaux interne/egress et filtrage Docker en lecture seule P1.
Normalise les fins de ligne (.gitattributes).

Palier de risque : n/a (doc + conventions).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-23 01:00:45 +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%