Skip to content

ynotopec/coder-brain

Repository files navigation

Coder Brain

POC Node.js d’orchestration IA en 4 phases (contexte, exécution, agrégation, sortie) avec mode online par défaut (clé OpenAI requise), et mode offline uniquement si activé explicitement (OPENAI_OFFLINE=true).

Démarrage en < 10 min

Prérequis

  • Node.js >= 20
  • npm >= 10

Installation déterministe

make install

Cette commande utilise npm ci pour garantir une installation reproductible via package-lock.json.

Configuration explicite

Copiez le fichier d’exemple puis choisissez un mode:

cp .env.example .env
  • Mode online: renseigner OPENAI_API_KEY
  • Mode offline: mettre OPENAI_OFFLINE=true

Lancement en une commande

make run

Cette commande lance le serveur web sur http://localhost:8080.

Alternative sans Make:

npm start

Interface web

npm start

Puis ouvrez http://localhost:8080 pour utiliser l'interface web moderne et progressive.

Exemple reproductible (entrée/sortie)

Commande:

make run-cli-offline

Entrée utilisée par le script:

  • What is 42 + 58?

Exemple de sortie (abrégée):

🚀 Brain-System Quick Start
💬 User Input: What is 42 + 58?
💬 System Response: { ... metadata: { phase: "chat" ... } }
✅ Setup complete! Your Brain-System is ready.

Structure

  • src/phase1: normalisation + routage d’intention
  • src/phase2: moteurs RAG / action / hybrid / chat safety
  • src/phase3: agrégation et scoring qualité
  • src/phase4: finalisation et mémoire

Documentation projet

  • Vue d’ensemble: docs/overview.md
  • Architecture: docs/architecture.md
  • State flow (router + séquence critique): docs/state-flow.md
  • Cas d’usage: USE_CASE.md
  • Valeur métier: VALUE.md
  • Statut innovation: INNOVATION_STATUS.md
  • Prompt agent projet: AGENT_PROJECT_PROMPT.md

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors