Démarrage rapide

Créez votre premier projet d'agent Astreus en moins de 5 minutes. Découvrez les schémas de configuration, les API et les exemples pratiques nécessaires pour...

Créez votre premier projet d'agent Astreus en moins de 5 minutes.

Méthodes d'installation

Avec npx (Recommandé)

npx create-astreus-agent my-agent

Avec npm create

npm create astreus-agent my-agent

Avec pnpm

pnpm create astreus-agent my-agent

Configuration interactive

1. Nom du projet

? What is your project name? my-agent

Entrez le nom de votre projet. Un nouveau répertoire sera créé. Seuls les lettres, chiffres, tirets et underscores sont autorisés.

2. Sélection des fonctionnalités

? Which features do you want to include?
  ◉ Memory - Persistent agent memory with vector search
  ◉ Knowledge (RAG) - Document ingestion and retrieval
  ◯ Graph Workflows - DAG-based task orchestration
  ◯ Sub-Agents - Multi-agent coordination
  ◯ Custom Plugins - Extensible tool system
  ◯ MCP Integration - Model Context Protocol support

Utilisez les flèches et la barre d'espace pour sélectionner les fonctionnalités. Toutes les fonctionnalités sont optionnelles.

3. Fournisseur LLM

? Which LLM provider do you want to use?
  ● OpenAI - GPT-4, GPT-3.5
  ○ Anthropic - Claude
  ○ Google - Gemini
  ○ Ollama - Local models
  ○ Multiple providers - Configure later

Choisissez votre fournisseur préféré ou sélectionnez "Multiple providers" pour configurer plus tard.

4. TypeScript

? Use TypeScript? Yes

TypeScript est recommandé pour une meilleure expérience développeur.

Post-installation

Une fois le projet créé :

# Accéder au projet
cd my-agent

# Installer les dépendances
npm install

# Copier le modèle d'environnement
cp .env.example .env

# Éditer .env avec vos clés API
nano .env  # ou utilisez votre éditeur préféré

# Démarrer l'agent
npm run dev

Exemple : Première conversation

Une fois lancé, votre agent est prêt :

import { Agent } from '@astreus-ai/astreus';
import 'dotenv/config';

const agent = await Agent.create({
  name: 'my-agent',
  model: 'gpt-4o',
  memory: true,
});

// Have a conversation
const response = await agent.ask("Hello! What can you help me with?");
console.log(response);

Code généré

Le CLI génère un fichier src/index.ts complet :

import { Agent } from '@astreus-ai/astreus';
import 'dotenv/config';

async function main() {
  console.log('Starting Astreus Agent...\n');

  const agent = await Agent.create({
    name: 'my-agent',
    model: 'gpt-4o',
    systemPrompt: 'You are a helpful AI assistant powered by Astreus.',
    memory: true,
  });

  // Interactive loop
  const readline = await import('readline');
  const rl = readline.createInterface({
    input: process.stdin,
    output: process.stdout,
  });

  console.log('Agent ready! Type your message (or "exit" to quit):\n');

  const prompt = () => {
    rl.question('You: ', async (input) => {
      if (input.toLowerCase() === 'exit') {
        console.log('\nGoodbye!');
        rl.close();
        process.exit(0);
      }

      try {
        const response = await agent.ask(input);
        console.log(`\nAgent: ${response}\n`);
      } catch (error) {
        console.error('Error:', error instanceof Error ? error.message : error);
      }

      prompt();
    });
  };

  prompt();
}

main().catch(console.error);

Prérequis

Node.js >= 22.0.0
npm, yarn, ou pnpm
Clé API du fournisseur LLM (ou Ollama pour les modèles locaux)

Prochaines étapes

Fonctionnalités - Découvrez chaque fonctionnalité
Configuration - Configuration de l'environnement

Dernière mise à jour : 6 juillet 2026

Dans cette section

Modèles

Informations sur les modèles de projet et les configurations courantes. Découvrez les schémas de configuration, les API et les exemples pratiques...

Configuration

Variables d'environnement et options de configuration pour votre projet d'agent Astreus. Découvrez les schémas de configuration, les API et les exemples...

Introduction

Fonctionnalités