GitHub
Retour à AgentOS

Construit au grand jour. Faites-le tourner vous-même.

AgentOS est petit, open source et sous licence MIT. Compilez-le depuis les sources, voyez comment ses pièces s’assemblent, et joignez votre ordinateur de partout avec votre propre relais.

Lancez-le depuis les sources.

Vous préférez le compiler vous-même ? Il vous faut un Mac, Node.js 20.19 ou plus récent, et pnpm 10.

  1. 1 Récupérer le code et le compiler 

    git clone https://github.com/Synapsr/AgentOS.git
cd AgentOS
pnpm install
pnpm build

  2. 2 Réveiller l’agent, sans clé pour l’instant 

    AGENTOS_ENGINE=mock pnpm start

    Un cerveau d’entraînement : aucune clé, aucun coût, tout le reste est réel. Il affiche l’adresse où terminer la configuration.

  3. 3 Lui donner un vrai cerveau 

    pnpm start

    Lance agentos start, le cœur seul. Collez une clé API Anthropic pendant la configuration, ou plus tard dans les Réglages.

  4. 4 Ajouter votre téléphone 

    pnpm agentos pair

    Affiche un QR code à usage unique.

  5. Depuis un terminal pnpm agentos say "…" Et aussi status, pair et url.

    L’app de bureau pnpm desktop Tauri 2 : il vous faut Rust.

    L’app iPhone cd apps/ios && xcodegen Puis ouvrez le projet dans Xcode.

Tout tient dans des fichiers simples.

Pas de base de données. Ce que sait Nova vit dans ~/.agentos, lisible avec n’importe quel éditeur.

  • ~/.agentos/
  • config.json qui est l’agent, ce qu’il demande
  • secrets.json les clés API, lisibles par vous seul
  • devices.json les appareils associés, en empreintes
  • events.jsonl tout ce qui s’est passé
  • threads/ un fichier par conversation
  • files/ captures d’écran et autres fichiers

Un petit protocole.

HTTP et WebSocket, en JSON, défini dans packages/protocol. Tous les clients le parlent : les apps, le client web, vos scripts.

Trois pièces, toutes remplaçables.

AgentOS est petit, et c’est voulu. Le cœur tourne sur votre ordinateur et garde la conversation, les demandes et les règles de sécurité. Tout le reste vient s’y brancher.

Vous

  • iPhone
  • Écouteurs
  • Navigateur
  • Apple Watch, en cours

Un petit protocole, documenté

Votre ordinateur

Le cœur d’AgentOS : conversations, demandes, règles de sécurité, fichiers simples.

  • Le cerveau

    Claude, via le Claude Agent SDK. Le moteur est une interface : d’autres modèles peuvent s’y brancher.

    • Claude
    • Votre modèle, même interface

  • Les yeux et les mains

    L’arbre d’accessibilité de votre système, via agent-desktop, open source. Nova lit ce qui est à l’écran et agit dessus : boutons, champs, menus.

    • agent-desktop

  • Les oreilles et la voix

    La voix de votre téléphone par défaut, sans clé. Ajoutez une clé pour une voix premium comme ElevenLabs, ou branchez votre propre serveur vocal open source.

    • Votre téléphone
    • ElevenLabs
    • Votre serveur

Joignez votre ordinateur de partout, à votre façon.

Votre téléphone et votre ordinateur se parlent directement. Des trois façons, choisissez celle qui vous va.

  1. Sur le même réseau

    À la maison ou au bureau, votre téléphone trouve votre ordinateur tout seul, et la connexion est chiffrée avec le certificat propre à votre ordinateur.

  2. De partout, avec Tailscale

    Installez Tailscale sur les deux. AgentOS le repère et met cette adresse dans le code d’association. Tailscale chiffre la connexion, et il n’y a aucun serveur à faire tourner.

  3. De partout, avec votre relais

    Lancez un petit conteneur sur un serveur à vous. Il est privé : il n’accepte que les ordinateurs qui présentent son jeton. C’est votre ordinateur qui s’y connecte : rien à ouvrir sur votre réseau.

Votre relais. Pas encore d’image publiée : vous le construisez depuis votre clone. Une image viendra avec la première version.

docker build -f packages/relay/Dockerfile -t agentos-relay .

RELAY_TOKEN=$(openssl rand -hex 32)
echo "$RELAY_TOKEN"     # your computer will need it
docker run -d -p 8080:8080 -v agentos-relay:/data -e RELAY_TOKEN="$RELAY_TOKEN" agentos-relay

Donnez ensuite à votre ordinateur l’adresse du relais et son jeton, dans Réglages › Avancé. Celui qui fait tourner un relais peut lire ce qui le traverse : faites tourner le vôtre. Le chiffrement de bout en bout entre téléphone et ordinateur est prévu.

Plusieurs ordinateurs ?

Associez-les un par un. Votre téléphone les montre ensemble, chacun avec son agent.

Avec chaque agent, une seule conversation, et dessous autant de tâches de fond qu’il lui en faut.

  • Nova Mac du studio · Je lance les tests
  • Iris MacBook Air · Rien à faire
  • Atlas Mac mini du bureau · Votre ordinateur est injoignable