openrouterteam/create-agent

Que fait create-agent ?

Créez un agent IA modulaire avec le SDK OpenRouter, des hooks extensibles et une interface TUI optionnelle basée sur Ink.

Installation

npx @openrouterteam/create-agent

Ou avec un répertoire cible :

npx @openrouterteam/create-agent mon-agent

Utilisation

1. Lancez la commande d'initialisation.
2. Suivez les instructions interactives.
3. Une fois le projet créé, placez-vous dans le répertoire :

cd mon-agent

4. Configurez votre clé API OpenRouter :

export OPENROUTER_API_KEY=sk-votre-cle-ici

5. Lancez l'agent :

npm start

Fonctionnalités

• Modulaire : chaque composant (appel API, logique de l'agent, interface) est séparé.
• Hooks extensibles : ajoutez facilement des comportements personnalisés (logging, mémoire, etc.).
• Interface TUI optionnelle : utilisez Ink (React pour le terminal) pour une interface interactive.
• TypeScript : typage fort pour une meilleure maintenabilité.
• Support multi-modèles : grâce au SDK OpenRouter, accédez à GPT, Claude, Gemini et bien d'autres.

Structure du projet

mon-agent/
  src/
    agent.ts          # Logique principale de l'agent
    hooks/            # Dossier pour les hooks personnalisés
      logger.ts       # Exemple de hook de journalisation
    tui/              # Code optionnel pour l'interface Ink
      index.tsx
    index.ts          # Point d'entrée
  package.json
  tsconfig.json
  README.md

Hooks disponibles

Hook	Description
onMessage	Déclenché après chaque message reçu
onError	Gère les erreurs de l'API ou internes
onToolCall	Intercepte les appels d'outils (function calling)

Personnalisation

Pour créer un hook, ajoutez un fichier dans src/hooks/ et enregistrez-le dans agent.ts :

import { monHook } from './hooks/monHook';

const agent = createAgent({
  hooks: [monHook],
  // ...
});

Dépendances principales

• openrouter SDK
• ink (optionnel, pour la TUI)
• react (pour Ink)
• typescript

Licence

MIT