Démarrage rapide

Lancez votre premier agent IA en 5 minutes.

Prérequis

• Une clé API de n'importe quel fournisseur de LLM pris en charge (OpenAI, Anthropic, Google, xAI ou un modèle local)
• macOS, Linux ou Windows (WSL)

Installation

Script (recommandé) :

curl -fsSL https://get.droid.plus | sh

Docker :

docker pull sinapticai/droid:latest

Téléchargement du binaire :

Téléchargez le binaire correspondant à votre plateforme depuis les GitHub Releases.

Plateforme	Architecture	Téléchargement
Linux	amd64	droid-linux-amd64
Linux	arm64	droid-linux-arm64
macOS	Apple Silicon	droid-darwin-arm64
macOS	Intel	droid-darwin-amd64
Windows	amd64	droid-windows-amd64.exe

Créez votre premier agent

Option A : Interface Builder IA (sans code)

Lancez Sinaptic® DROID+ et ouvrez le constructeur visuel :

droid up
# Ouvrez http://localhost:8081/builder/ dans votre navigateur

L'interface Builder IA vous permet de configurer votre agent visuellement : choisissez un modèle, rédigez un prompt système, ajoutez des outils et testez-le en direct. Une fois terminé, elle génère la configuration YAML pour vous.

Option B : Configuration YAML

Initialisez un nouveau projet :

droid init mon-agent
cd mon-agent

Cela crée un répertoire de projet avec :

mon-agent/
├── droid.yaml          # Configuration d'exécution (ports, clés LLM, sécurité)
├── configs/agents/
│   └── mon-agent.yaml  # Définition de votre agent
├── .env.example        # Modèle de clé API
└── data/               # Données d'exécution (RAG, logs)

Éditez .env.example → .env avec votre clé API :

cp .env.example .env
# Éditez .env et ajoutez votre OPENAI_API_KEY (ou toute autre clé de fournisseur)

Lancez le moteur d'exécution :

droid up

Vous verrez s'afficher :

 ____  ____   ___  ___ ____
|  _ \|  _ \ / _ \|_ _|  _ \  _
| | | | |_) | | | || || | | |(_)_
| |_| |  _ <| |_| || || |_| |  _|
|____/|_| \_\\___/|___|____/  (_)

Sinaptic.AI DROID+ v0.5.0
Agent runtime engine starting...
✓ Loaded 1 agent: mon-agent
✓ SinapticAI security: enabled (community mode)
✓ OpenAI-compatible API: http://localhost:8080/v1
✓ Management API: http://localhost:8081
✓ Agent Builder UI: http://localhost:8081/builder/

Discutez avec votre agent

Sinaptic® DROID+ expose une API compatible OpenAI, vous pouvez donc utiliser n'importe quel SDK OpenAI ou simplement curl :

curl :

curl http://localhost:8080/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mon-agent",
    "messages": [{"role": "user", "content": "Bonjour !"}]
  }'

Python (SDK OpenAI) :

from openai import OpenAI

client = OpenAI(base_url="http://localhost:8080/v1", api_key="any")

response = client.chat.completions.create(
    model="mon-agent",
    messages=[{"role": "user", "content": "Bonjour !"}]
)

print(response.choices[0].message.content)

Node.js (SDK OpenAI) :

import OpenAI from 'openai';

const client = new OpenAI({
  baseURL: 'http://localhost:8080/v1',
  apiKey: 'any',
});

const response = await client.chat.completions.create({
  model: 'mon-agent',
  messages: [{ role: 'user', content: 'Bonjour !' }],
});

console.log(response.choices[0].message.content);

Le champ model correspond au nom de l'agent dans votre configuration YAML. La api_key peut être n'importe quelle chaîne de caractères pour le développement local (à moins que vous n'ayez configuré l'authentification dans droid.yaml).

Explication de la configuration de l'agent

Voici une configuration d'agent minimale (configs/agents/mon-agent.yaml) :

name: "mon-agent"
description: "Assistant de support client"

model:
  name: "gpt-4o-mini"       # N'importe quel modèle de votre fournisseur configuré
  max_tokens: 1024
  temperature: 0.7

personality: |
  Vous êtes un assistant de support client utile.
  Soyez concis et précis. Soyez toujours poli.

tools:
  - name: "current_time"
    type: "builtin"

sinaptic:
  enabled: true              # Activer les contrôles de sécurité

Champs clés :

• name — identifiant unique de l'agent, utilisé comme model dans les appels API.
• model.name — le modèle de LLM à utiliser (ex: gpt-4o-mini, claude-sonnet-4-20250514, gemini-2.0-flash).
• personality — prompt système qui définit le comportement de l'agent.
• tools — outils intégrés, points de terminaison d'API REST ou serveurs MCP que l'agent peut utiliser.
• sinaptic.enabled — activer/désactiver la sécurité SinapticAI (détection d'injection de prompts, masquage de PII).

Commandes CLI

droid up          # Démarrer le moteur (charge tous les agents)
droid down        # Arrêter proprement une instance en cours
droid init NAME   # Créer un nouveau projet d'agent
droid agents      # Lister les agents chargés et leur statut
droid health      # Vérifier l'état de santé du serveur
droid version     # Afficher la version, le commit et la date de build

Étapes suivantes

• Fournisseurs de LLM — Configurer OpenAI, Anthropic, Gemini, Grok ou des modèles locaux.
• Outils MCP — Ajouter des outils externes via le Model Context Protocol.
• Sécurité SinapticAI — Comprendre la couche de sécurité intégrée.
• Déploiement Docker — Exécuter Sinaptic® DROID+ en production avec Docker.
• Éditions — Comparer les fonctionnalités des versions Community, Pro et Enterprise.