Avvio rapido

Crea il tuo primo progetto di agente Astreus in meno di 5 minuti. Scopri i pattern di configurazione, le API e gli esempi pratici necessari per creare...

Crea il tuo primo progetto di agente Astreus in meno di 5 minuti.

Metodi di installazione

Usando npx (consigliato)

npx create-astreus-agent my-agent

Usando npm create

npm create astreus-agent my-agent

Usando pnpm

pnpm create astreus-agent my-agent

Configurazione interattiva

1. Nome del progetto

? What is your project name? my-agent

Inserisci il nome del tuo progetto. Verrà creata una nuova directory. Sono consentite solo lettere, numeri, trattini e underscore.

2. Selezione delle funzionalità

? 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

Usa i tasti freccia e la barra spaziatrice per selezionare le funzionalità. Tutte le funzionalità sono opzionali.

3. Provider 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

Scegli il provider preferito oppure seleziona "Multiple providers" per configurarlo in seguito.

4. TypeScript

? Use TypeScript? Yes

TypeScript è consigliato per una migliore esperienza di sviluppo.

Dopo l'installazione

Dopo che il progetto è stato creato:

# Vai alla directory del progetto
cd my-agent

# Installa le dipendenze
npm install

# Copia il modello dell'ambiente
cp .env.example .env

# Modifica .env con le tue chiavi API
nano .env  # oppure usa il tuo editor preferito

# Avvia l'agente
npm run dev

Esempio: prima conversazione

Una volta avviato, il tuo agente è pronto:

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);

Codice generato

La CLI genera un src/index.ts completo:

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);

Requisiti

Node.js >= 22.0.0
npm, yarn o pnpm
Chiave API del provider LLM (oppure Ollama per i modelli locali)

Prossimi passi

Funzionalità - Scopri ogni funzionalità
Configurazione - Impostazione dell'ambiente

Ultimo aggiornamento: 6 luglio 2026

In questa sezione

Template

Informazioni sui template di progetto e sulle configurazioni comuni. Scopri i pattern di configurazione, le API e gli esempi pratici necessari per creare...

Configurazione

Variabili d'ambiente e opzioni di configurazione per il tuo progetto di agente Astreus. Scopri i pattern di configurazione, le API e gli esempi pratici...

Introduzione

Funzionalità