Assistant de configuration

La commande prx onboard cree votre fichier de configuration initial en vous guidant a travers la selection du fournisseur, la saisie de la cle API, le choix du modele et la configuration du backend memoire. C'est la methode recommandee pour configurer PRX pour la premiere fois.

Ce que fait Onboard

Lorsque vous executez prx onboard, l'assistant effectue les etapes suivantes :

1. Selectionne un fournisseur LLM -- Vous invite a choisir parmi les 9 fournisseurs pris en charge (Anthropic, OpenAI, Google Gemini, Ollama, OpenRouter, etc.)
2. Stocke votre cle API -- Ecrit de maniere securisee vos identifiants fournisseur dans le fichier de configuration
3. Recupere les modeles disponibles -- Interroge l'API du fournisseur pour lister les modeles auxquels vous avez acces
4. Definit un modele par defaut -- Vous permet de choisir le modele a utiliser par defaut
5. Configure le backend memoire -- Choisit entre Markdown (base fichiers), SQLite ou PostgreSQL
6. Ecrit le fichier de configuration -- Cree ~/.config/openprx/openprx.toml avec vos parametres

Apres la configuration, PRX est pret a fonctionner avec prx daemon ou prx chat.

Mode interactif

L'experience de configuration par defaut est la configuration rapide, qui ne pose que les questions essentielles. Pour un assistant interactif complet qui parcourt chaque section de configuration, utilisez le drapeau --interactive :

prx onboard --interactive

L'assistant interactif inclut une configuration supplementaire pour :

• Parametres d'hote et de port de la passerelle
• Pre-configuration des canaux (Telegram, Discord, etc.)
• Securite et niveau d'autonomie
• Repertoire de l'espace de travail
• Parametres d'observabilite

Configuration rapide (par defaut)

La commande prx onboard par defaut lance une configuration rapide simplifiee :

prx onboard

Cela demande votre fournisseur, votre cle API et votre modele -- rien de plus. Tous les autres parametres utilisent des valeurs par defaut raisonnables.

Configuration rapide avec drapeaux

Ignorez entierement les invites interactives en passant des drapeaux :

prx onboard \
  --provider anthropic \
  --api-key sk-ant-api03-xxxxxxxxxxxx \
  --model claude-sonnet-4-20250514

Drapeaux disponibles :

Drapeau	Description	Exemple
--provider	Nom du fournisseur LLM	anthropic, openai, ollama, openrouter
--api-key	Cle API ou identifiant du fournisseur	sk-ant-..., sk-...
--model	Identifiant du modele par defaut	claude-sonnet-4-20250514, gpt-4o
--memory	Backend memoire	markdown, sqlite, postgres
--interactive	Lancer l'assistant interactif complet	(pas de valeur)
--channels-only	Relancer uniquement l'assistant de reparation des canaux	(pas de valeur)

Exemples

Anthropic Claude avec les parametres par defaut :

prx onboard --provider anthropic --api-key "$ANTHROPIC_API_KEY"

Ollama local (pas de cle API requise) :

prx onboard --provider ollama --model llama3.2

OpenRouter avec un modele specifique :

prx onboard --provider openrouter --api-key "$OPENROUTER_API_KEY" --model anthropic/claude-sonnet-4-20250514

OpenAI avec memoire SQLite :

prx onboard --provider openai --api-key "$OPENAI_API_KEY" --model gpt-4o --memory sqlite

Fichier de configuration

L'assistant de configuration ecrit la configuration dans :

~/.config/openprx/openprx.toml

Sous Linux, cela suit la specification XDG Base Directory. Sous macOS, il utilise ~/Library/Application Support/openprx/openprx.toml sauf si XDG_CONFIG_HOME est defini.

Exemple de configuration generee

Apres avoir execute prx onboard --provider anthropic --model claude-sonnet-4-20250514, la configuration generee ressemble a ceci :

# OpenPRX Configuration
# Generated by: prx onboard

# ── Provider ──────────────────────────────────────────────
default_provider = "anthropic"
default_model = "claude-sonnet-4-20250514"
default_temperature = 0.7
api_key = "sk-ant-api03-xxxxxxxxxxxx"

# ── Workspace ─────────────────────────────────────────────
workspace_dir = "~/.local/share/openprx"

# ── Memory ────────────────────────────────────────────────
[memory]
backend = "markdown"
# path defaults to workspace_dir/memory

# ── Gateway ───────────────────────────────────────────────
[gateway]
host = "127.0.0.1"
port = 3120

# ── Channels ──────────────────────────────────────────────
[channels]
cli = true

# ── Security ──────────────────────────────────────────────
[security]
autonomy = "supervised"

Vous pouvez modifier ce fichier a tout moment. PRX prend en charge le rechargement a chaud -- la plupart des modifications prennent effet sans redemarrer le daemon.

Sections de la configuration

Le fichier de configuration prend en charge les sections de premier niveau suivantes :

Section	Objectif
default_provider	Fournisseur LLM a utiliser par defaut
default_model	Modele a utiliser par defaut
api_key	Identifiant API du fournisseur
[memory]	Backend memoire et parametres de stockage
[gateway]	Configuration de la passerelle HTTP/WebSocket
[channels]	Configurations des canaux de messagerie
[channels.telegram]	Parametres du bot Telegram
[channels.discord]	Parametres du bot Discord
[security]	Niveau d'autonomie, sandbox, politiques
[router]	Strategie de routage LLM
[self_system]	Parametres du pipeline d'auto-evolution
[observability]	Metriques, tracing, journalisation
[cron]	Configuration des taches planifiees
[plugins]	Chemins et parametres des plugins WASM

Consultez la Reference complete de la configuration pour chaque option disponible.

Verification post-configuration

Apres la configuration, lancez la commande de diagnostic pour verifier que tout est correctement configure :

prx doctor

Le diagnostic verifie :

• Fichier de configuration -- Valide la syntaxe TOML et les champs requis
• Connectivite du fournisseur -- Teste la cle API en interrogeant le fournisseur
• Disponibilite du modele -- Confirme que le modele selectionne est accessible
• Backend memoire -- Verifie que le backend de stockage est accessible en ecriture
• Dependances systeme -- Verifie les outils optionnels (git, docker, etc.)
• Reseau -- Teste la connectivite aux services configures

Exemple de sortie :

PRX Doctor

  Config file .............. OK  (~/.config/openprx/openprx.toml)
  Provider (anthropic) ..... OK  (authenticated)
  Model .................... OK  (claude-sonnet-4-20250514)
  Memory (markdown) ........ OK  (writable)
  Gateway port (3120) ...... OK  (available)
  Git ...................... OK  (2.43.0)
  Docker ................... WARN (not installed -- sandbox features limited)

All critical checks passed.

Sous-commandes du diagnostic

Le diagnostic dispose egalement de sous-commandes pour des diagnostics cibles :

# Sonder les catalogues de modeles pour tous les fournisseurs
prx doctor models

# Sonder les modeles pour un fournisseur specifique
prx doctor models --provider anthropic

Assistant de reparation des canaux

Si vous avez deja termine la configuration et souhaitez ajouter ou corriger des configurations de canaux, utilisez le drapeau --channels-only :

prx onboard --channels-only

Cela ignore la configuration du fournisseur et du modele et va directement a la configuration des canaux.

Relancer Onboard

Vous pouvez relancer prx onboard a tout moment. L'assistant detecte votre configuration existante et propose de la mettre a jour plutot que de la reecrire depuis zero. Vos configurations de canaux existantes, vos donnees memoire et vos parametres personnalises sont preserves.

Prochaines etapes

• Demarrage rapide -- Demarrer le daemon et discuter
• Canaux -- Connecter des plateformes de messagerie
• Reference de la configuration -- Liste complete de toutes les options de configuration