Installer et piloter Igris

Prérequis

Installation

La version affichée par la CLI doit être 3.6.1.

python -m venv .venv
python -m pip install -e ".[dev]"

# Copier .env.example vers .env, puis renseigner les secrets locaux
igris config doctor-env
igris --version

Configuration minimale

DEEPSEEK_API_KEY=...
DEEPSEEK_MODEL=deepseek-v4-pro
IGRIS_AGENT_IGRIS_MODEL=deepseek-v4-flash
IGRIS_DATABASE_URL=postgresql://igris:igris@localhost:5432/igris
IGRIS_OLLAMA_BASE_URL=http://localhost:11434
IGRIS_WEBSEARCH_ENABLED=true
IGRIS_WEBFETCH_ENABLED=true
IGRIS_TIMEZONE=Europe/Paris

# Optionnel, réservé aux images et vidéos
OPENROUTER_API_KEY=...

OpenRouter n’est pas un fallback texte : il est utilisé par les tools de génération d’images et de vidéos.

Dashboard Product Owner

igris dashboard construit l’image si nécessaire, démarre le profil Docker dashboard, attend l’API puis ouvre une session locale authentifiée sur le port 8790.

# Construit et démarre le dashboard, PostgreSQL et le Control Plane
igris dashboard

# Prépare les sandboxes Python, Node et Flutter
igris sandbox prepare

# Contrôles de disponibilité
igris tools doctor
igris e2e check

Le dashboard réunit Chat, projets, Kanban, Context Manager, Database, Monitoring et le centre Outils & Sprints.

Tool Registry et Web public

igris tools doctor compare le registre MCP, la visibilité provider, les dépendances et la policy Chat. Le testeur n’accepte que les tools explicitement classés en lecture seule.

igris web search "météo Paris demain"
igris web fetch https://example.com/article

igris tools test web.search --arguments '{"query":"météo Paris demain"}'
igris tools test web.fetch --arguments '{"url":"https://example.com"}'

web.fetch refuse localhost, les adresses privées, loopback, link-local, multicast ou réservées, limite les redirections et revalide chaque destination.

Sprints et contrôle coopératif

Une pause ou un arrêt prend effet au prochain point sûr du DAG. Les commentaires Product Owner, blocages volontaires, rapports intermédiaires et relances ciblées sont persistés.

igris sprint status SPRINT_ID --project PROJECT_ID
igris sprint pause SPRINT_ID --project PROJECT_ID
igris sprint continue SPRINT_ID --project PROJECT_ID
igris sprint report SPRINT_ID --project PROJECT_ID
igris sprint retry-task SPRINT_ID TASK_ID --project PROJECT_ID

Les mêmes transitions sont exposées graphiquement dans Outils & Sprints et dans la modale détaillée du Sprint Control Center.

Diagnostic et reprise

igris e2e check audite la chaîne Product Owner sans exécuter de mission. igris e2e repair réconcilie les User Stories et Sprints interrompus sans rejouer les tâches terminées.

igris e2e check
igris e2e repair
igris services doctor --profile full

Points d’entrée et stockage