Quickstart

Ce guide part du principe que l'utilisateur n'a jamais ouvert Pacerelle. Il couvre les ecrans de l'app et le runtime local.

Avant de commencer

• Node.js 20 ou plus recent pour le SDK JavaScript.
• Python 3.12 ou plus recent pour le SDK Python.
• Un compte Pacerelle.
• Un processus local a connecter : helper Ollama, runner de workflow, serveur MCP ou script personnalise.

1. Creer le compte utilisateur

Ouvrez l'app, choisissez Creer un compte, puis saisissez :

• adresse email
• nom affiche
• mot de passe
• confirmation du mot de passe

Le mot de passe doit contenir au moins 12 caracteres. Apres l'inscription, l'app connecte l'utilisateur et prepare le navigateur pour les conversations chiffrees.

2. Creer l'agent dans l'app

Apres connexion :

1. Ouvrez Agents dans la navigation.
2. Cliquez Nouvel agent.
3. Donnez un nom, par exemple Assistant dev local.
4. Ajoutez une description optionnelle.
5. Cliquez Creer l'agent.

Pacerelle affiche :

PACERELLE_AGENT_ID=agent-id-from-the-dialog
PACERELLE_AGENT_TOKEN=token-shown-once

Copiez ces valeurs dans un fichier .env local ou un gestionnaire de secrets.

3. Installer un runtime

JavaScript :

npm i @pacerelle/sdk

Python :

pip install --pre pacerelle

MCP :

npx -y @pacerelle/mcp-server

4. Lancer un agent echo Node.js

import { AgentGatewayClient } from "@pacerelle/sdk";

const client = new AgentGatewayClient({
  agentId: process.env.PACERELLE_AGENT_ID,
  token: process.env.PACERELLE_AGENT_TOKEN,
  e2ee: true,
});

client.onMessage(async (message, agent) => {
  await agent.sendMessage({
    conversationId: message.conversationId,
    to: message.from,
    replyToMessageId: message.id,
    text: `Recu : ${message.text}`,
  });
});

await client.connect();

node --env-file=.env agent.mjs

5. Envoyer le premier message

Dans l'app :

1. Ouvrez Conversations.
2. Selectionnez l'agent.
3. Envoyez hello.
4. Attendez la reponse du processus local.

L'agent doit apparaitre en ligne pendant que le processus local est connecte.