Démarrage rapide
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-agentAvec npm create#
npm create astreus-agent my-agentAvec pnpm#
pnpm create astreus-agent my-agentConfiguration interactive#
1. Nom du projet#
? What is your project name? my-agentEntrez 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 supportUtilisez 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 laterChoisissez votre fournisseur préféré ou sélectionnez "Multiple providers" pour configurer plus tard.
4. TypeScript#
? Use TypeScript? YesTypeScript 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 devExemple : 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