Introduction

🎯 Qu'est-ce qu'Appstrate ?

Appstrate est une plateforme open-source de type Agent as a Service. Elle permet d'exécuter des agents IA autonomes dans des conteneurs Docker éphémères et isolés. Chaque agent est défini par un prompt, se connecte aux services de l'utilisateur (Gmail, Slack, Notion, GitHub...), et traite ses données de manière autonome.

Contrairement aux outils de workflow automation (n8n, Zapier), Appstrate ne repose pas sur des graphes d'étapes prédéfinies. Un agent reçoit un prompt, des credentials, et un contexte — puis l'IA décide comment accomplir la tâche.

⚙️ Comment ça fonctionne

Utilisateur → Configure un agent (prompt + providers)
                ↓
           Lance un run
                ↓
        ┌───────────────────────────┐
        │  Réseau Docker isolé      │
        │                           │
        │  ┌─────────┐ ┌─────────┐  │
        │  │ Sidecar │ │  Agent  │  │
        │  │ (proxy) │ │ (Pi/Bun)│  │
        │  └─────────┘ └─────────┘  │
        └───────────────────────────┘
                ↓
     Résultat + State + Logs

Le sidecar est un proxy HTTP qui injecte les credentials de l'utilisateur dans les requêtes sortantes. L'agent n'a jamais accès direct aux secrets — il appelle le sidecar, qui substitue les tokens avant de relayer vers l'API externe.

✨ Fonctionnalités principales

• Exécution éphémère — chaque run crée un conteneur Docker isolé, détruit après usage
• Providers OAuth — connectez Gmail, Slack, Notion, GitHub et 18+ services via OAuth2/PKCE, API key, ou credentials custom
• Scheduling — planifiez des runs via cron distribué (BullMQ + Redis)
• Packages AFPS — importez et partagez des agents, skills, tools et providers au format AFPS
• API Headless — 191 endpoints OpenAPI 3.1 pour intégrer Appstrate dans vos applications
• Multi-tenant — organisations, applications, rôles, invitations, clés API
• End-users — gérez les utilisateurs de votre produit via l'API et exécutez des agents en leur nom
• Webhooks — recevez des notifications sur les événements de vos runs
• Auto-hébergement — un seul docker compose up pour déployer
• Infrastructure progressive — du zero-install (PGlite + filesystem) au full Docker, 4 niveaux

👥 À qui s'adresse Appstrate ?

Développeurs et équipes techniques qui veulent intégrer des agents IA dans leurs produits. Appstrate fournit l'infrastructure d'exécution, l'isolation, la gestion des credentials et l'API — vous fournissez le prompt et les connexions.

Cas d'usage typiques :

• Automatisation d'emails et de tâches répétitives
• Agents de support client connectés à vos outils internes
• Pipelines de traitement de données pilotés par IA
• Agents CI/CD qui analysent vos pull requests

🚀 Par où commencer ?

• Quickstart — installez et lancez votre premier agent en 5 minutes
• Concepts — comprenez l'architecture (agents, providers, runs, packages)
• Référence API — explorez les 191 endpoints
• Auto-hébergement — déployez sur votre infrastructure