Référence des Fichiers de Configuration

Ce document présente la spécification complète du fichier de configuration yevi.config.yaml et des variables d’environnement reconnues par Yevi Core v1.0 (Licence Open Source MIT).

Toutes les options sont modifiables sans recompilation du moteur pour faciliter les déploiements On-Premise, VPS souverains ou sur Appliance physique YEVI-BOX.

---

1. Fichier yevi.config.yaml : exemple complet de production

# Fichier de Configuration Yevi Core v1.0
version: "1.0"
environment: "production" # development | staging | production

server:
  host: "127.0.0.1"
  port: 8000
  cors_allowed_origins:
    - "http://localhost:3000"
    - "https://yevi.entreprise.internal"

privacy_vault:
  enabled: true
  encryption: "AES-256-GCM"
  spacy_model: "fr_core_news_sm"
  auto_purge_ram_sec: 0
  entities:
    person_names: true
    organizations: true
    locations: true
    emails: true
    phone_numbers: true
    iban: true
    social_security_nir: true
  custom_regex:
    - name: "MATRICULE_EMPLOYE"
      pattern: "EMP-\\d{6}"
      label: "EMP_ID"

rag:
  chunk_size: 512
  chunk_overlap: 50
  hybrid_search: true
  rrf_k: 60
  top_k: 4
  strict_citations: true

vector_db:
  provider: "chromadb"
  persist_directory: "/var/lib/yevi/chroma_db"
  collection_name: "enterprise_knowledge"

llm:
  provider: "ollama" # ollama | vllm | dummy
  base_url: "http://localhost:11434"
  model_name: "llama3.3:8b-instruct-q4_K_M"
  temperature: 0.1
  max_tokens: 2048

logging:
  level: "INFO" # DEBUG | INFO | WARNING | ERROR
  audit_jsonl_path: "/var/log/yevi/audit.jsonl"

---

2. Variables d’environnement (Surcharges .env)

Chaque directive du fichier yevi.config.yaml peut être surchargée par une variable d’environnement au démarrage du service :

Variable d’Environnement	Description	Valeur par défaut
YEVI_ENV	Environnement d’exécution (development / production)	production
YEVI_SERVER_PORT	Port d’écoute du serveur FastAPI	8000
YEVI_VAULT_KEY	Clé secrète maître pour la RAM Vault (base64 AES-256)	Générée aléatoirement en RAM
YEVI_LLM_PROVIDER	Moteur d’inférence (ollama, vllm, dummy)	ollama
YEVI_LLM_BASE_URL	URL de l’API LLM locale	http://localhost:11434
YEVI_LLM_MODEL	Nom du modèle d’inférence quantifié	llama3.3
YEVI_VECTORDB_PATH	Répertoire de stockage persistant ChromaDB	./chroma_db
YEVI_AUDIT_LOG_PATH	Chemin du fichier de journalisation JSONL opposable	/var/log/yevi/audit.jsonl

[!NOTE] Les variables d’environnement sont prioritaires sur le fichier YAML, ce qui permet une intégration fluide dans vos manifests Docker et orchestrateurs Kubernetes / Nomad.

---

🛠️ Ressources & documentation associée

• 📄 Référence des Endpoints API REST
• 📄 Référence de la CLI Yevi
• ⚙️ Guide de Configuration & Tuning du Privacy Vault PII
• 🚀 Guide d’Inférence LLM Locale (vLLM, Ollama & DeepSeek R1)
• 💻 Accéder au code source open source sur GitHub (Licence MIT)