Guide Développeur

Comment utiliser Argy en tant que développeur : Argy Code, LLM Gateway, et modules gouvernés (golden paths).

Argy aide les développeurs à livrer via des briques standardisées et gouvernées (modules / golden paths) et un accès IA gouverné (LLM Gateway), sans contourner la sécurité, la conformité ou les standards plateforme.

Argy Code (Terminal)

Argy Code est un agent IA en ligne de commande pour les développeurs, pensé pour l’usage quotidien comme pour l’automatisation.

Modes d’exécution

Interactif (TUI) : confirmations humaines pour le développement.
Autonome (argy run) : exécution non-interactive avec codes de sortie déterministes (CI/CD, scripts, automatisation).

Installation

# Homebrew
brew install demkada/tap/argy

# curl (Linux / macOS)
curl -fsSL https://github.com/demkada/argy-code/releases/latest/download/install.sh | sh

Authentification

Argy prend en charge le Device Flow (RFC 8628) pour les terminaux et agents, ainsi que les Personal Access Tokens (PAT).

argy auth login

Les PAT sont configurables (durée de 7 jours à 1 an), avec un maximum de 25 jetons actifs par utilisateur, et révocables à tout moment.

Commandes principales

argy models          # Lister les modèles disponibles
argy mcp list        # Lister les serveurs MCP (outils)
argy agent list      # Lister les agents disponibles
argy run "prompt"    # Exécution autonome (CI/CD)
argy session list    # Historique des sessions
argy stats           # Statistiques d’usage
argy serve           # Serveur HTTP local pour accès SDK

LLM Gateway (API compatible OpenAI)

Le LLM Gateway est le point d’entrée unifié vers les fournisseurs de LLM (OpenAI, Anthropic, Mistral, xAI, Google), avec une gouvernance intégrée : quotas, filtres de sécurité et audit complet.

Endpoints

POST /v1/chat/completions
POST /v1/embeddings
POST /v1/agent/steps
GET /v1/models

Argy est multi-tenant. Les requêtes portent le contexte tenant et organisation via des headers :

x-tenant-id
x-org-id

Exemple : chat completion

# Choisissez un ID de modèle via GET /v1/models
curl -X POST https://<votre-llm-gateway>/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "x-tenant-id: <tenant-id>" \
  -H "x-org-id: <org-id>" \
  -d '{
    "model": "<model-id>",
    "messages": [
      { "role": "user", "content": "Résume ces logs de run en 5 bullet points." }
    ]
  }'

Modules & Golden Paths (self-service avec garde-fous)

Argy encapsule les standards d’entreprise sous forme de modules versionnés (golden paths) : provisionnement d’infrastructure, étapes CI/CD, contrôles de sécurité, étapes d’approbation et conventions opérationnelles. Les développeurs les consomment via le portail et Argy Code, tandis que la plateforme garde le contrôle via le versioning et la gouvernance.