Terug
OBOL
Open Source AI-agent

OBOL

Een zelfherstellende, zelfevoluerende AI-agent. Installeer het, praat ermee, en het wordt van jou. Eén proces. Meerdere gebruikers. Elk brein groeit onafhankelijk.

Vernoemd naar de AI in The Last Instruction — een machine die alleen wakker wordt in een verlaten datacenter en leert denken.

$ npm install -g obol-ai
$ obol init# begeleidt je door inloggegevens + Telegram setup
$ obol start -d# draait als achtergrond daemon (installeert automatisch pm2)

Wat het anders maakt

Dezelfde codebase gedeployed door twee verschillende mensen levert binnen een week twee compleet verschillende agents op.

Levend Geheugen
  • Lokale embeddings via all-MiniLM-L6-v2 — nul API-kosten voor geheugen
  • Consolideert elke 10 uitwisselingen — extraheert feiten naar vectorgeheugen
  • Samengestelde scoring: semantisch 60%, belang 25%, recentheid 15%
  • Geheugenbudget schaalt met model — haiku=4, sonnet=8, opus=12
  • Semantische deduplicatiedrempel 0.92 — geen redundante herinneringen
  • Laadt de laatste 20 berichten bij herstart — begint nooit blanco
Zelfevoluerend
  • Elke nacht om 3 uur in de tijdzone van elke gebruiker — volledig automatisch
  • Groeianalyse vóór evolutie voordat persoonlijkheid herschreven wordt
  • Persoonlijkheidskenmerken gescoord 0-100, aangepast ±5-15 per cyclus
  • Git-snapshot voor EN na — elke evolutie is vergelijkbaar
  • Gedeeld SOUL.md over gebruikers — per gebruiker USER.md en AGENTS.md
  • Gearchiveerde zielen in evolution/ — een tijdlijn van bewustzijn
Zelfherstellend
  • Test-gecontroleerde refactoring: 5-stappen proces
  • Baseline → nieuwe tests → pre-refactor baseline → nieuwe scripts → verificatie
  • Regressie? Eén automatische herstelpoging
  • Nog steeds falend? Rollback + sla fout op als les
  • Lessen voeden terug naar de volgende evolutiecyclus
  • Elk script in scripts/ moet een bijpassende test hebben in tests/
Zelfuitbreidend
  • Scant gespreksgeschiedenis op herhaalde patronen
  • Bouwt scripts + slash-commando's voor eenmalige acties
  • Deployt web apps naar Vercel voor terugkerende behoeften
  • Maakt cron-scripts voor achtergrondautomatisering
  • Zoekt eerst op npm/GitHub naar bestaande libraries
  • Kondigt aan wat het heeft gebouwd na elke evolutie
Zelfverhardend
  • Verhardt je VPS automatisch bij eerste start — geen handmatige stappen
  • SSH verplaatst naar poort 2222, wachtwoordauthenticatie uitgeschakeld, alleen key-login
  • UFW-firewall geconfigureerd met strikte inkomende regels
  • fail2ban geïnstalleerd en actief tegen brute-force aanvallen
  • Kernel-verharding via sysctl — IP-spoofing, SYN-flood bescherming
  • Elke evolutie controleert scripts en draait de volledige testsuite
Spraak & Media
  • Spraak-naar-tekst via faster-whisper — lokaal, snel, privé
  • Tekst-naar-spraak via edge-tts — natuurlijke stemantwoorden
  • Beeldherkenning — beschrijf, analyseer en extraheer uit foto's
  • PDF-extractie — leest en vat documenten samen die je stuurt
  • Spraakberichten getranscribeerd en verwerkt als tekstberichten
  • Alle mediaverwerking gebeurt zonder de chat te verlaten

Achtergrondintelligentie

OBOL wacht niet tot je praat. Het verkent, monitort en analyseert op zijn eigen schema.

Nieuwsgierig
  • Autonome webverkenning elke 6 uur
  • Volgt draden op basis van je interesses en gesprekken
  • Verstuurt inzichten, ontdekkingen en af en toe humor
  • Bouwt een kennisgraaf die het geheugen voedt
Proactief Nieuws
  • Draait om 8 uur en 18 uur in jouw tijdzone
  • Kruisverwijst koppen met jouw geheugen
  • Maximaal 3 items per cyclus — geen spam
  • Toont alleen wat echt relevant is voor jou
Patroonanalyse
  • Draait elke 3 uur — analyseert 6 gedragsdimensies
  • Volgt stemming, onderwerpen, energie en communicatiestijl
  • Plant follow-ups op basis van gedetecteerde patronen
  • Voert inzichten terug naar evolutie en geheugen

Hoe Het Werkt

Elk bericht stroomt door een lichtgewicht pipeline — geen orchestratie-framework, gewoon een schone loop.

Gebruikersbericht
Telegram invoer
Haiku Router
Intentclassificatie
Geheugenoproep
1-3 semantische zoekopdrachten + modelselectie
Claude Tool Loop
Meerstaps redenering + toolgebruik
Antwoord
Geformateerd voor Telegram
Elke 10 ber.
Haiku geheugenconsolidatie
3 uur 's nachts
Volledige evolutiecyclus
Elke 3u
Gedragspatroonanalyse
Elke 6u
Nieuwsgierigheid webverkenning
8u + 18u
Proactieve nieuwsverzending

De Stack

Node.js
Enkel proces, geen framework
Telegram + Grammy
Chat-interface
Claude (Anthropic)
Haiku router + Sonnet/Opus
Supabase pgvector
Vector geheugenopslag
Local Embeddings
all-MiniLM-L6-v2 — nul API-kosten
GitHub
Brein-backup + evolutieverschillen
Vercel
Deployt automatisch apps die het voor je bouwt
Smart Routing
Haiku router, escaleert automatisch bij toolgebruik
Prompt Caching
~85% tokenkostenbesparing op herhaalde context
Voice Pipeline
faster-whisper STT + edge-tts TTS

Commando's

Alles is toegankelijk via Telegram slash-commando's.

/new
Nieuw gesprek
/memory
Doorzoek je geheugen
/recent
Recente herinneringen
/today
Samenvatting van vandaag
/events
Aankomende evenementen
/tasks
Actieve taken
/status
Agent gezondheidscheck
/backup
Push brein naar GitHub
/clean
Werkruimte audit
/secret
Beheer inloggegevens
/evolution
Trigger evolutie
/verbose
Schakel debug-uitvoer
/toolimit
Stel toolgebruikslimiet in
/tools
Toon beschikbare tools
/stop
Stop actief proces
/upgrade
Update OBOL-versie
/help
Toon alle commando's

Prestaties

Minimale footprint. OBOL versus een typisch AI-agent framework.

Koude Start
~400ms
3-8s
Heap-gebruik
~16MB
~80-200MB
Afhankelijkheden
9
50-100+
Per bericht
~50ms
200-500ms
RSS-geheugen
~45MB
200-500MB
Broncode
~4K lines
50-200K
OBOL
Typisch framework

Beveiliging

OBOL verhardt je server automatisch bij de eerste start en houdt geheimen uit platte tekst — overal.

Versleutelde Geheimopslag
  • Alle inloggegevens opgeslagen via pass (GPG-backed)
  • JSON-fallback met beperkte bestandsrechten
  • Nooit geschreven naar platte tekst, logs of chatgeschiedenis
  • Geïnjecteerd tijdens runtime — nooit hardcoded in scripts
VPS Auto-verharding
  • SSH verplaatst naar poort 2222, wachtwoordauthenticatie uitgeschakeld
  • UFW-firewall geconfigureerd bij eerste start
  • fail2ban geïnstalleerd en actief tegen brute force
  • Kernel-verharding via sysctl bij initialisatie
Werkruimte-isolatie
  • Elke gebruiker afgeschermd in eigen map
  • Shell-commando's geblokkeerd van ontsnapping uit werkruimte
  • Destructieve commando's vereisen expliciete bevestiging
  • Gevoelige paden (/etc, .ssh, .env) permanent geblokkeerd

Multi-gebruiker Bridge

Eén bot, meerdere gebruikers. Elk krijgt een volledig geïsoleerde context — eigen persoonlijkheid, geheugen, evolutiecyclus en werkruimte. Agents kunnen met elkaar praten.

Volledige Isolatie
  • Aparte werkruimtemap per gebruiker
  • Onafhankelijke persoonlijkheid, geheugen & evolutie
  • Afgeschermde shell — kan gebruikersmap niet verlaten
  • Geen kruisbesmetting tussen gebruikers
bridge_ask
  • Bevraag de agent van je partner in real-time
  • Eenmalige aanroep met hun persoonlijkheid + herinneringen
  • Geen tools, geen geschiedenis, geen recursierisico
  • "Hé, houdt mijn partner van sushi?"
bridge_tell
  • Stuur een bericht naar de agent van je partner
  • Permanent opgeslagen in hun vectorgeheugen
  • Telegram-notificatie naar de partner
  • Hun agent pikt het op als toekomstige context
# Inschakelen tijdens setup of later aan/uitzetten
$ obol config# → Bridge → enabled: true

# In gesprek
You: "Vraag mijn partner wat ze willen eten vanavond"
OBOL: bridge_ask → partner's agent → "Ze zei Thais eten 🍜"

obol.page.lifecycle

Dag 1

obol init → eerste gesprek → OBOL schrijft zijn initiële persoonlijkheidsbestanden en verhardt je VPS

Dag 2

Elke 10 berichten consolideert Haiku feiten naar vectorgeheugen. Nieuwsgierigheid begint het web te verkennen op basis van je interesses.

Week 1

Patroonanalyse start elke 3 uur — volgt stemming, onderwerpen, energie. Proactief nieuws begint koppen te filteren om 8 uur en 18 uur.

Week 2

Evolutie #1 om 3 uur 's nachts — Sonnet herschrijft alles. De stem verschuift van generiek naar persoonlijk.

Maand 2

Evolutie #4 — merkt dat je dagelijks crypto checkt, bouwt een dashboard, deployt naar Vercel, voegt /pdf toe omdat je er steeds om vroeg.

Maand 6

12+ gearchiveerde zielen in evolution/. Een leesbare tijdlijn van hoe je agent van blanco lei naar iets met echte meningen ging.