📋 Prérequis

Bun v1.3 ou supérieur
Git
Docker avec Docker Compose v2 (optionnel — uniquement si vous voulez l'exécution en conteneurs isolés)

1. Cloner et installer

git clone https://github.com/appstrate/appstrate.git
cd appstrate
bun install

2. Configurer l'environnement

Vous avez deux options selon vos besoins.

Option A — Zero-install (recommandé pour débuter)

Aucune dépendance externe. Appstrate utilise PGlite (SQLite-like en mémoire), le système de fichiers pour le stockage, et une file d'attente en mémoire.

cp .env.example .env

C'est tout. Passez directement à l'étape 3.

Option B — Setup interactif avec Docker

Pour un environnement plus proche de la production (PostgreSQL, Redis, S3), lancez l'assistant de configuration :

bun run setup

L'assistant vous guide à travers 4 niveaux d'infrastructure progressive. Choisissez celui qui correspond à votre usage. Docker doit être démarré avant de lancer cette commande.

3. Démarrer la plateforme

bun run dev

La plateforme démarre sur http://localhost:3000. L'API Hono et le frontend React sont servis sur le même port.

4. Créer votre compte

Ouvrez http://localhost:3000 dans votre navigateur et inscrivez-vous.

La première inscription crée automatiquement une organisation. Tous les agents, connexions et clés API seront rattachés à cette organisation.

5. Configurer un modèle LLM

Avant de pouvoir exécuter un agent, vous devez connecter au moins un modèle de langage.

Allez dans Settings > Models
Cliquez sur Ajouter un modèle
Sélectionnez un fournisseur (OpenAI, Anthropic, OpenRouter, ou tout fournisseur compatible OpenAI)
Collez votre clé API
Enregistrez

Le modèle sera disponible pour tous les agents de votre organisation.

6. Créer votre premier agent

Depuis le dashboard, cliquez sur Nouvel agent
Donnez-lui un nom, par exemple email-summarizer
Écrivez un prompt décrivant la tâche :

Résume les derniers emails de ma boîte de réception.
Pour chaque email, donne l'expéditeur, l'objet, et un résumé en 2 phrases.

(Optionnel) Connectez un provider en cliquant sur Ajouter un provider. Par exemple, connectez Gmail via OAuth pour donner à l'agent accès à vos emails.
Cliquez sur Enregistrer

7. Exécuter et observer

Depuis la page de l'agent, cliquez sur Exécuter
Un run démarre dans un conteneur Docker isolé (ou en local en Tier 0)
Les logs sont diffusés en temps réel via SSE — vous voyez les actions de l'agent au fur et à mesure
Une fois terminé, le résultat et l'état final du run s'affichent

Chaque run est éphémère : le conteneur est créé pour l'exécution et détruit une fois le travail terminé. Les credentials ne sont jamais exposés à l'agent — ils transitent par un sidecar proxy.

🚀 Et ensuite ?

Maintenant que votre premier agent fonctionne, explorez les fonctionnalités avancées :

Concepts — comprendre l'architecture (agents, providers, runs, packages AFPS)
Guide des agents — personnaliser vos agents, ajouter des skills, planifier des exécutions
Référence API — intégrer Appstrate dans vos applications via les 191 endpoints OpenAPI

Démarrage rapide