Volver
OBOL
Agente de IA Open Source

OBOL

Un agente de IA auto-reparable y auto-evolutivo. Instálalo, háblale y se vuelve tuyo. Un proceso. Múltiples usuarios. Cada cerebro crece independientemente.

Nombrado en honor a la IA de The Last Instruction — una máquina que despierta sola en un centro de datos abandonado y aprende a pensar.

$ npm install -g obol-ai
$ obol init# te guía por las credenciales + configuración de Telegram
$ obol start -d# se ejecuta como daemon en segundo plano (auto-instala pm2)

Qué lo hace diferente

El mismo código desplegado por dos personas diferentes produce dos agentes completamente distintos en una semana.

Memoria Viva
  • Embeddings locales vía all-MiniLM-L6-v2 — cero costo de API para memoria
  • Consolida cada 10 intercambios — extrae hechos a memoria vectorial
  • Puntuación compuesta: semántica 60%, importancia 25%, recencia 15%
  • Presupuesto de memoria escala con el modelo — haiku=4, sonnet=8, opus=12
  • Umbral de deduplicación semántica 0.92 — sin memorias redundantes
  • Carga los últimos 20 mensajes al reiniciar — nunca empieza en blanco
Auto-Evolutivo
  • Cada noche a las 3am en la zona horaria de cada usuario — completamente automático
  • Análisis de crecimiento pre-evolución antes de reescribir la personalidad
  • Rasgos de personalidad puntuados 0-100, ajustados ±5-15 cada ciclo
  • Snapshot de Git antes Y después — cada evolución es diferenciable
  • SOUL.md compartido entre usuarios — USER.md y AGENTS.md por usuario
  • Almas archivadas en evolution/ — una línea temporal de consciencia
Auto-Reparable
  • Refactorización con tests: proceso de 5 pasos
  • Línea base → nuevos tests → línea base pre-refactorización → nuevos scripts → verificar
  • ¿Regresión? Un intento de corrección automático
  • ¿Sigue fallando? Rollback + almacenar fallo como lección
  • Las lecciones se retroalimentan en el siguiente ciclo de evolución
  • Cada script en scripts/ debe tener un test correspondiente en tests/
Auto-Extensible
  • Escanea el historial de conversaciones en busca de patrones repetidos
  • Construye scripts + comandos slash para acciones puntuales
  • Despliega apps web en Vercel para necesidades recurrentes
  • Crea scripts cron para automatización en segundo plano
  • Busca primero librerías existentes en npm/GitHub
  • Anuncia lo que construyó después de cada evolución
Auto-Blindaje
  • Endurece tu VPS automáticamente en la primera ejecución — sin pasos manuales
  • SSH movido al puerto 2222, autenticación por contraseña deshabilitada, solo acceso por clave
  • Firewall UFW configurado con reglas estrictas de entrada
  • fail2ban instalado y activo contra ataques de fuerza bruta
  • Endurecimiento del kernel vía sysctl — protección contra IP spoofing, SYN flood
  • Cada evolución audita scripts y ejecuta la suite completa de tests
Voz y Multimedia
  • Speech-to-text vía faster-whisper — local, rápido, privado
  • Text-to-speech vía edge-tts — respuestas con voz natural
  • Visión de imágenes — describe, analiza y extrae de fotos
  • Extracción de PDF — lee y resume documentos que envías
  • Notas de voz transcritas y procesadas como mensajes de texto
  • Todo el procesamiento multimedia ocurre sin salir del chat

Inteligencia en Segundo Plano

OBOL no espera a que le hables. Explora, monitorea y analiza según su propio horario.

Curioso
  • Exploración web autónoma cada 6 horas
  • Sigue hilos basados en tus intereses y conversaciones
  • Envía insights, descubrimientos y humor ocasional
  • Construye un grafo de conocimiento que alimenta la memoria
Noticias Proactivas
  • Se ejecuta a las 8am y 6pm en tu zona horaria
  • Cruza titulares con tu memoria
  • Máximo 3 elementos por ciclo — sin spam
  • Solo muestra lo que realmente es relevante para ti
Análisis de Patrones
  • Se ejecuta cada 3 horas — analiza 6 dimensiones de comportamiento
  • Rastrea estado de ánimo, temas, energía y estilo de comunicación
  • Programa seguimientos basados en patrones detectados
  • Retroalimenta los insights en evolución y memoria

Cómo Funciona

Cada mensaje fluye a través de un pipeline ligero — sin framework de orquestación, solo un bucle limpio.

Mensaje del Usuario
Entrada de Telegram
Haiku Router
Clasificación de intención
Recuperación de Memoria
1-3 consultas semánticas + selección de modelo
Claude Tool Loop
Razonamiento multi-paso + uso de herramientas
Respuesta
Formateada para Telegram
Cada 10 msgs
Consolidación de memoria con Haiku
3am cada noche
Ciclo completo de evolución
Cada 3h
Análisis de patrones de comportamiento
Cada 6h
Exploración web por curiosidad
8am + 6pm
Envío proactivo de noticias

El Stack

Node.js
Proceso único, sin framework
Telegram + Grammy
Interfaz de chat
Claude (Anthropic)
Haiku router + Sonnet/Opus
Supabase pgvector
Almacén de memoria vectorial
Local Embeddings
all-MiniLM-L6-v2 — cero costo de API
GitHub
Respaldo del cerebro + diffs de evolución
Vercel
Auto-despliega apps que construye para ti
Smart Routing
Haiku router, auto-escala en uso de herramientas
Prompt Caching
~85% reducción de costo de tokens en contexto repetido
Voice Pipeline
faster-whisper STT + edge-tts TTS

Comandos

Todo es accesible vía comandos slash de Telegram.

/new
Conversación nueva
/memory
Buscar en tu memoria
/recent
Memorias recientes
/today
Resumen de hoy
/events
Próximos eventos
/tasks
Tareas activas
/status
Chequeo de salud del agente
/backup
Respaldar cerebro en GitHub
/clean
Auditar espacio de trabajo
/secret
Gestionar credenciales
/evolution
Activar evolución
/verbose
Alternar salida de depuración
/toolimit
Establecer límite de uso de herramientas
/tools
Listar herramientas disponibles
/stop
Detener proceso activo
/upgrade
Actualizar versión de OBOL
/help
Mostrar todos los comandos

Rendimiento

Huella mínima. OBOL vs un framework típico de agentes de IA.

Arranque en Frío
~400ms
3-8s
Uso de Heap
~16MB
~80-200MB
Dependencias
9
50-100+
Por mensaje
~50ms
200-500ms
Memoria RSS
~45MB
200-500MB
Código Fuente
~4K lines
50-200K
OBOL
Framework típico

Seguridad

OBOL endurece tu servidor automáticamente en la primera ejecución y mantiene los secretos fuera del texto plano — en todas partes.

Almacén de Secretos Encriptado
  • Todas las credenciales almacenadas vía pass (respaldado por GPG)
  • Fallback JSON con permisos de archivo restringidos
  • Nunca escritos en texto plano, logs o historial de chat
  • Inyectados en tiempo de ejecución — nunca hardcodeados en scripts
Auto-Endurecimiento de VPS
  • SSH movido al puerto 2222, autenticación por contraseña deshabilitada
  • Firewall UFW configurado en la primera ejecución
  • fail2ban instalado y activo contra fuerza bruta
  • Endurecimiento del kernel vía sysctl en inicialización
Aislamiento de Espacio de Trabajo
  • Cada usuario aislado en su propio directorio
  • Comandos shell bloqueados de escapar del espacio de trabajo
  • Comandos destructivos requieren confirmación explícita
  • Rutas sensibles (/etc, .ssh, .env) bloqueadas permanentemente

Puente Multi-Usuario

Un bot, múltiples usuarios. Cada uno obtiene un contexto completamente aislado — su propia personalidad, memoria, ciclo de evolución y espacio de trabajo. Los agentes pueden hablar entre sí.

Aislamiento Completo
  • Directorio de espacio de trabajo separado por usuario
  • Personalidad, memoria y evolución independientes
  • Shell aislado — no puede escapar del directorio de usuario
  • Sin contaminación cruzada entre usuarios
bridge_ask
  • Consulta al agente de tu pareja en tiempo real
  • Llamada única con su personalidad + memorias
  • Sin herramientas, sin historial, sin riesgo de recursión
  • "Oye, ¿a mi pareja le gusta el sushi?"
bridge_tell
  • Envía un mensaje al agente de tu pareja
  • Almacenado en su memoria vectorial permanentemente
  • Notificación de Telegram a la pareja
  • Su agente lo recoge como contexto futuro
# Habilitar durante la configuración o cambiar después
$ obol config# → Bridge → enabled: true

# En conversación
You: "Pregúntale a mi pareja qué quiere cenar"
OBOL: bridge_ask → partner's agent → "Dijo que comida tailandesa 🍜"

obol.page.lifecycle

Día 1

obol init → primera conversación → OBOL escribe sus archivos de personalidad iniciales y endurece tu VPS

Día 2

Cada 10 mensajes, Haiku consolida hechos en memoria vectorial. La curiosidad comienza a explorar la web basándose en tus intereses.

Semana 1

El análisis de patrones se activa cada 3h — rastrea estado de ánimo, temas, energía. Las noticias proactivas empiezan a filtrar titulares a las 8am y 6pm.

Semana 2

Evolución #1 a las 3am — Sonnet reescribe todo. La voz pasa de genérica a personal.

Mes 2

Evolución #4 — nota que revisas crypto diariamente, construye un dashboard, lo despliega en Vercel, agrega /pdf porque seguías pidiendo.

Mes 6

12+ almas archivadas en evolution/. Una línea temporal legible de cómo tu agente pasó de ser una hoja en blanco a algo con opiniones reales.