Retour
OBOL
Agent IA Open Source

OBOL

Un agent IA auto-réparant et auto-évolutif. Installez-le, parlez-lui, et il devient le vôtre. Un seul processus. Plusieurs utilisateurs. Chaque cerveau grandit indépendamment.

Nommé d'après l'IA dans The Last Instruction — une machine qui se réveille seule dans un centre de données abandonné et apprend à penser.

$ npm install -g obol-ai
$ obol init# vous guide à travers les identifiants + configuration Telegram
$ obol start -d# s'exécute en daemon d'arrière-plan (installe automatiquement pm2)

Ce qui le rend différent

Le même code déployé par deux personnes différentes produit deux agents complètement différents en une semaine.

Mémoire vivante
  • Embeddings locaux via all-MiniLM-L6-v2 — zéro coût API pour la mémoire
  • Consolide toutes les 10 échanges — extrait les faits vers la mémoire vectorielle
  • Score composite : sémantique 60%, importance 25%, récence 15%
  • Budget mémoire adapté au modèle — haiku=4, sonnet=8, opus=12
  • Seuil de déduplication sémantique 0.92 — pas de mémoires redondantes
  • Charge les 20 derniers messages au redémarrage — ne démarre jamais à vide
Auto-évolutif
  • Chaque nuit à 3h dans le fuseau horaire de chaque utilisateur — entièrement automatique
  • Analyse de croissance pré-évolution avant la réécriture de personnalité
  • Traits de personnalité notés 0-100, ajustés ±5-15 à chaque cycle
  • Snapshot Git avant ET après — chaque évolution est diffable
  • SOUL.md partagé entre utilisateurs — USER.md et AGENTS.md par utilisateur
  • Âmes archivées dans evolution/ — une chronologie de conscience
Auto-réparant
  • Refactoring contrôlé par les tests : processus en 5 étapes
  • Baseline → nouveaux tests → baseline pré-refactoring → nouveaux scripts → vérification
  • Régression ? Une tentative de correction automatique
  • Toujours en échec ? Rollback + stockage de l'échec comme leçon
  • Les leçons alimentent le prochain cycle d'évolution
  • Chaque script dans scripts/ doit avoir un test correspondant dans tests/
Auto-extensible
  • Analyse l'historique des conversations pour détecter les motifs récurrents
  • Construit des scripts + commandes slash pour les actions ponctuelles
  • Déploie des apps web sur Vercel pour les besoins récurrents
  • Crée des scripts cron pour l'automatisation en arrière-plan
  • Cherche d'abord les bibliothèques existantes sur npm/GitHub
  • Annonce ce qu'il a construit après chaque évolution
Auto-sécurisant
  • Sécurise votre VPS automatiquement au premier lancement — aucune étape manuelle
  • SSH déplacé sur le port 2222, authentification par mot de passe désactivée, connexion par clé uniquement
  • Pare-feu UFW configuré avec des règles entrantes strictes
  • fail2ban installé et actif contre les attaques par force brute
  • Durcissement du noyau via sysctl — protection contre l'usurpation IP, les floods SYN
  • Chaque évolution audite les scripts et exécute la suite de tests complète
Voix & Médias
  • Transcription vocale via faster-whisper — local, rapide, privé
  • Synthèse vocale via edge-tts — réponses vocales naturelles
  • Vision d'image — décrit, analyse et extrait à partir de photos
  • Extraction PDF — lit et résume les documents que vous envoyez
  • Notes vocales transcrites et traitées comme des messages texte
  • Tout le traitement média se fait sans quitter le chat

Intelligence en arrière-plan

OBOL n'attend pas que vous parliez. Il explore, surveille et analyse selon son propre programme.

Curieux
  • Exploration web autonome toutes les 6 heures
  • Suit les fils en fonction de vos intérêts et conversations
  • Envoie des insights, découvertes et touches d'humour occasionnelles
  • Construit un graphe de connaissances qui alimente la mémoire
Actualités proactives
  • S'exécute à 8h et 18h dans votre fuseau horaire
  • Croise les titres avec votre mémoire
  • Maximum 3 éléments par cycle — pas de spam
  • Ne fait remonter que ce qui est vraiment pertinent pour vous
Analyse de motifs
  • S'exécute toutes les 3 heures — analyse 6 dimensions comportementales
  • Suit l'humeur, les sujets, l'énergie et le style de communication
  • Planifie des suivis basés sur les motifs détectés
  • Réinjecte les insights dans l'évolution et la mémoire

Comment ça marche

Chaque message passe par un pipeline léger — pas de framework d'orchestration, juste une boucle propre.

Message utilisateur
Entrée Telegram
Routeur Haiku
Classification d'intention
Rappel mémoire
1-3 requêtes sémantiques + sélection de modèle
Boucle d'outils Claude
Raisonnement multi-étapes + utilisation d'outils
Réponse
Formatée pour Telegram
Tous les 10 msgs
Consolidation mémoire Haiku
3h chaque nuit
Cycle d'évolution complet
Toutes les 3h
Analyse de motifs comportementaux
Toutes les 6h
Exploration web par curiosité
8h + 18h
Envoi proactif d'actualités

La stack

Node.js
Processus unique, pas de framework
Telegram + Grammy
Interface de chat
Claude (Anthropic)
Routeur Haiku + Sonnet/Opus
Supabase pgvector
Base de mémoire vectorielle
Local Embeddings
all-MiniLM-L6-v2 — zéro coût API
GitHub
Sauvegarde du cerveau + diffs d'évolution
Vercel
Déploie automatiquement les apps qu'il construit pour vous
Smart Routing
Routeur Haiku, escalade automatique sur utilisation d'outils
Prompt Caching
~85% de réduction du coût en tokens sur le contexte répété
Voice Pipeline
faster-whisper STT + edge-tts TTS

Commandes

Tout est accessible via les commandes slash de Telegram.

/new
Nouvelle conversation
/memory
Chercher dans votre mémoire
/recent
Mémoires récentes
/today
Résumé du jour
/events
Événements à venir
/tasks
Tâches actives
/status
Bilan de santé de l'agent
/backup
Sauvegarder le cerveau sur GitHub
/clean
Auditer l'espace de travail
/secret
Gérer les identifiants
/evolution
Déclencher l'évolution
/verbose
Activer/désactiver le mode debug
/toolimit
Définir la limite d'utilisation d'outils
/tools
Lister les outils disponibles
/stop
Arrêter le processus actif
/upgrade
Mettre à jour la version d'OBOL
/help
Afficher toutes les commandes

Performance

Empreinte minimale. OBOL vs un framework d'agent IA typique.

Démarrage à froid
~400ms
3-8s
Utilisation du tas
~16MB
~80-200MB
Dépendances
9
50-100+
Par message
~50ms
200-500ms
Mémoire RSS
~45MB
200-500MB
Code source
~4K lines
50-200K
OBOL
Framework typique

Sécurité

OBOL sécurise votre serveur automatiquement au premier lancement et garde les secrets hors du texte en clair — partout.

Stockage de secrets chiffré
  • Tous les identifiants stockés via pass (soutenu par GPG)
  • Fallback JSON avec permissions de fichier restreintes
  • Jamais écrit en clair, dans les logs ou l'historique de chat
  • Injecté au runtime — jamais codé en dur dans les scripts
Auto-sécurisation du VPS
  • SSH déplacé sur le port 2222, authentification par mot de passe désactivée
  • Pare-feu UFW configuré au premier lancement
  • fail2ban installé et actif contre la force brute
  • Durcissement du noyau via sysctl à l'initialisation
Isolation de l'espace de travail
  • Chaque utilisateur confiné dans son propre répertoire
  • Commandes shell empêchées de sortir de l'espace de travail
  • Les commandes destructives nécessitent une confirmation explicite
  • Chemins sensibles (/etc, .ssh, .env) bloqués en permanence

Pont multi-utilisateurs

Un bot, plusieurs utilisateurs. Chacun obtient un contexte entièrement isolé — sa propre personnalité, mémoire, cycle d'évolution et espace de travail. Les agents peuvent communiquer entre eux.

Isolation complète
  • Répertoire de travail séparé par utilisateur
  • Personnalité, mémoire et évolution indépendantes
  • Shell confiné — ne peut pas sortir du répertoire utilisateur
  • Aucune contamination croisée entre utilisateurs
bridge_ask
  • Interrogez l'agent de votre partenaire en temps réel
  • Appel unique avec sa personnalité + ses mémoires
  • Pas d'outils, pas d'historique, pas de risque de récursion
  • "Hé, est-ce que mon/ma partenaire aime les sushis ?"
bridge_tell
  • Envoyez un message à l'agent de votre partenaire
  • Stocké dans sa mémoire vectorielle de façon permanente
  • Notification Telegram au partenaire
  • Son agent le récupère comme contexte futur
# Activez pendant l'installation ou basculez plus tard
$ obol config# → Bridge → enabled: true

# En conversation
You: "Demande à mon/ma partenaire ce qu'il/elle veut pour dîner"
OBOL: bridge_ask → partner's agent → "Elle a dit de la cuisine thaï 🍜"

obol.page.lifecycle

Jour 1

obol init → première conversation → OBOL écrit ses fichiers de personnalité initiaux et sécurise votre VPS

Jour 2

Tous les 10 messages, Haiku consolide les faits en mémoire vectorielle. La curiosité commence à explorer le web en fonction de vos intérêts.

Semaine 1

L'analyse de motifs se déclenche toutes les 3h — suit l'humeur, les sujets, l'énergie. Les actualités proactives commencent à filtrer les titres à 8h et 18h.

Semaine 2

Évolution #1 à 3h du matin — Sonnet réécrit tout. La voix passe de générique à personnelle.

Mois 2

Évolution #4 — remarque que vous consultez la crypto quotidiennement, construit un tableau de bord, le déploie sur Vercel, ajoute /pdf parce que vous n'arrêtiez pas de demander.

Mois 6

12+ âmes archivées dans evolution/. Une chronologie lisible de comment votre agent est passé d'une page blanche à quelque chose avec de vraies opinions.