Skip to content
arbrain-aiPublic

About

Tu cerebro artificial: un bucle hacia tu meta. Memoria, habilidades, rutinas y manos alrededor del mejor modelo, en tu computadora.

Topics

Resources

Security policy

Stars

8 stars

Watchers

0 watching

Forks

Repository files navigation


Qué es

Arbrain es tu cerebro artificial: un bucle hacia tu meta. Le dices a dónde quieres llegar y tu agente, Levy, lo convierte en un plan de mes, semana y día; lo agenda, lo ejecuta contigo, revisa qué se cumplió y ajusta. Cada vuelta del bucle sabe más de ti, porque todo lo que aprende queda escrito en tu memoria.

No es un chat más. El chat es la punta del iceberg. Debajo hay un sistema nervioso completo que corre en tu computadora: memoria, habilidades, rutinas y manos, conectados al mejor modelo disponible.

Por qué

  • La punta mejora sola. El modelo (Claude u otro) mejora cada pocos meses y Arbrain lo usa el mismo día. No tienes que reconstruir nada.
  • Lo de abajo es tuyo. Tu memoria, tus habilidades y tus rutinas son archivos de texto en tu disco, versionados en git. Los puedes leer, editar, respaldar y llevar a otro lado. Nadie te los puede quitar.
  • Crece con la IA. Cuanto mejor es el modelo, más rinde lo que construiste alrededor. Lo que hoy le enseñas a tu Levy sigue sirviendo con el modelo de dentro de cinco años.

Arquitectura de Arbrain: el modelo al centro; memoria, habilidades, rutinas y manos alrededor; todo dentro de tu computadora o tu servidor

Funciones

Memoria
Lo que Levy sabe de ti, de tu negocio y de tu meta, en archivos Markdown. Recuerda decisiones y correcciones entre conversaciones.
Habilidades
Skills que enseñan a Levy a hacer un trabajo de principio a fin. Vienen varias y creas las tuyas hablando.
Rutinas
Revisiones del día, la semana y el mes que Levy corre contigo, y ganchos que en cada sesión le cargan tu agenda y tu memoria.
Calendario y hábitos
Día, semana y mes en tu panel. «Agéndame…» o «agrega el hábito…» y Levy lo escribe en tu plan local, con rachas.
Voz
Dicta en lugar de escribir (con tu llave gratuita de Groq) y escucha las respuestas con la voz de tu dispositivo.
Lienzos
Una pizarra donde Levy dibuja mapas, planes y diagramas que tú editas a mano. Arranca con «Mi plan» y «12 semanas».
Panel
Chat, calendario, lienzo, explorador de archivos y taller en una sola ventana del navegador.
Manos
Levy usa tu computadora y la web por ti en macOS y Windows. Viene apagado y siempre pide permiso para lo irreversible.

Instalar

Funciona en macOS, Windows y Linux. No tienes que instalar nada antes: Claude Code se encarga de Git, Node y Python, sin pedirte comandos. Lo único que necesitas es una cuenta de Claude Pro o Max: Claude Code, que hace la instalación, no viene en el plan gratis.

  1. ¿Ya tienes Claude Code? Si sí, ábrelo. Si no: descarga la app de Claude de claude.ai/download, entra con tu cuenta (Pro o Max) y abre la pestaña Code. No necesitas una terminal. Si te pide una carpeta, elige tu carpeta personal (la que lleva tu nombre), en esta computadora.

  2. Pega este mensaje y envíalo:

    Instala Arbrain siguiendo https://github.com/arbrain-ai/arbrain/blob/main/INSTALAR.md
    
  3. Acepta los permisos que te pida (los de Claude Code y, si aparece, la ventana de tu sistema). Cuando se abra tu navegador, entra a tu cuenta de Claude y pulsa Autorizar. En unos minutos se abre la app Arbrain con Levy listo.

Tu Claude Code verifica la firma de la versión, instala lo que falte, respalda lo que ya tengas (la app 0.1.x, tu Business OS o tu propio repo) y te pregunta una sola vez si lo copia o lo unifica, baja Arbrain ya compilado para tu sistema, deja la app de escritorio abierta y conecta a Levy con tu cuenta de Claude. El guion completo está en INSTALAR.md.

Antes de pegar cualquier prompt, revisa de dónde viene. Un prompt le da órdenes a un agente que puede usar tu computadora. Este es el de esta página (el mismo que dan arbrain.ai y los videos de Arbrain) y apunta solo a github.com/arbrain-ai/arbrain. Si alguien te pasa uno parecido con otra dirección, no lo pegues.

Desinstalar o empezar desde cero: pega Desinstala Arbrain siguiendo https://github.com/arbrain-ai/arbrain/blob/main/INSTALAR.md. Guarda todo en ~/Arbrain-respaldos (no borra nada); luego el prompt de instalación lo deja como nuevo.

Para quien programa: a mano
git clone --origin dani https://github.com/arbrain-ai/arbrain.git ~/Arbrain
cd ~/Arbrain
git switch -c mi-arbrain                # tu rama: aquí vive todo lo tuyo
python3 arbrain/cerebro/sembrar.py      # siembra tu capa sin pisar nada
cd arbrain && npm run servidor          # baja el programa ya compilado (o compila) y abre tu navegador
node scripts/escritorio.mjs instalar    # la app de escritorio, verificada con la firma de la versión

Necesitas Git 2.34+, Node 22+ y Python 3. Arbrain queda en http://127.0.0.1 (solo en tu computadora). Comandos útiles, desde ~/Arbrain/arbrain:

Comando Qué hace
npm run servidor Arranca Arbrain y abre el navegador con tu sesión
npm run servidor -- estado Dice si está corriendo y en qué dirección
npm run servidor -- detener Lo apaga
npm run servidor -- contrasena Muestra la contraseña para entrar desde otro navegador
npm run servidor -- arranque-automatico activar Lo arranca solo al encender la computadora

El remoto se llama dani a propósito: es de donde llegan las versiones nuevas. Tu respaldo en tu propio GitHub privado va como origin (el instalador te lo ofrece al final).

Actualizar

Pega el mismo prompt de instalación, o abre Claude Code en ~/Arbrain y dile «actualiza mi Arbrain». Verifica la firma de la versión nueva, guarda tus cambios en una rama de respaldo, te explica en cinco líneas qué trae según el CHANGELOG.md, la integra en mi-arbrain sin tocar tu capa y reinicia Arbrain y su app. Solo te pregunta si un archivo que editaste choca con uno del autor.

Cómo funciona por dentro (capas, respaldo, firma y qué pasa si cambiaste algo del autor): docs/ACTUALIZAR-EXPLICADO.md.

Tu cuenta de Claude

Cada cuenta de Claude es individual y se usa en tu propio Claude Code, con tu sesión (Pro, Max o tu asiento de Team). Es la forma principal de trabajar con tu cerebro.

El chat dentro de Arbrain usa tu Claude Code solo: si ya iniciaste sesión, Arbrain lo conecta sin pedirte nada. Si no, en Ajustes › Llaves basta el botón «Iniciar sesión con Claude», que abre tu navegador en la página de Anthropic. Con este motor Arbrain no le pasa ninguna llave de API a Claude Code (aunque tengas ANTHROPIC_API_KEY en tu sistema), así que no se cobra aparte; las rutinas automáticas no corren con tu plan.

Si no tienes Pro o Max, el chat usa tu propia llave: OpenRouter («Conectar con OpenRouter», un clic) o una API key de Anthropic, en Ajustes. En ningún caso Arbrain pide, ve, guarda ni reenvía las credenciales de tu cuenta: el inicio de sesión es el de Anthropic, en tu propio Claude Code, y no se comparten cuentas entre personas (condiciones de Anthropic).

Estructura de capas

Hay dos capas y nunca se pisan. La del autor llega con cada versión; la tuya nace una sola vez de la semilla y vive en tu rama.

Capa Rutas Quién la cambia
Tuya .claude/memory/, .claude/plan/ (objetivos, calendario, hábitos), .claude/now.md, .claude/diario/, .claude/daily/, .claude/knowledge/, tus skills en .claude/skills/, CLAUDE.local.md, mi-negocio/, mi-marca/ (colores, logo y nombre) Tú y tu Levy, en mi-arbrain
Del autor CLAUDE.md, las skills que vienen con Arbrain, los ganchos, arbrain/ (el código) y la semilla Cada versión, en main
~/Arbrain
├── CLAUDE.md                 contrato de Levy (importa tu memoria)
├── CAPAS.json                la lista exacta de qué es tuyo y qué del autor
├── .claude/
│   ├── memory/               tu memoria            ← tuya
│   ├── plan/                 objetivos, calendario y hábitos  ← tuya
│   ├── skills/               habilidades del autor y las tuyas
│   └── hooks/                rutinas que cuidan tu memoria
└── arbrain/
    ├── cerebro/semilla/      de aquí nace tu capa la primera vez
    ├── scripts/servidor.mjs  npm run servidor
    ├── server/               el servicio local de Levy
    └── src/                  el panel (Next.js)

Si quieres que tu Levy sepa o haga algo distinto, escríbelo en tu memoria (.claude/memory/MEMORY.md) o en una skill tuya, no en CLAUDE.md: así las actualizaciones nunca chocan con lo tuyo. Para tus colores, tu logo o tu nombre, usa mi-marca/, no el código. Todos los lugares para extender sin editar están en docs/PERSONALIZAR.md.

Seguridad por defecto

  • Todo escucha solo en 127.0.0.1. No hay túneles ni puertos abiertos hacia afuera.
  • Tus llaves viven en un archivo privado de tu carpeta de datos, nunca en el repositorio.
  • Enviar, borrar, pagar o publicar siempre pide tu confirmación.
  • El control de la computadora viene apagado y se enciende en Ajustes.
  • La telemetría está apagada salvo que tú la aceptes.

Contribuir

Las ideas, los reportes y los PR son bienvenidos.

  1. Abre un issue con lo que viste o lo que propones.
  2. Para código: haz un fork, crea una rama desde main y abre un PR pequeño y con una sola idea.
  3. No incluyas datos personales, llaves ni archivos de la capa del usuario (CAPAS.json); la CI revisa esto último.

Este repositorio se publica por versiones: los PR aceptados se integran en la siguiente versión y aparecen en el CHANGELOG.md. Si encuentras una vulnerabilidad, repórtala en privado desde la pestaña Security del repositorio, no en un issue público.

Licencia

Apache-2.0. Puedes usar, modificar y distribuir Arbrain, también con fines comerciales, conservando el aviso de licencia y el NOTICE. El nombre y el logo de Arbrain son marcas de su autor.


arbrain.ai · YouTube

Hecho con Claude Code, para quien quiere un cerebro propio y no uno rentado.

About

Tu cerebro artificial: un bucle hacia tu meta. Memoria, habilidades, rutinas y manos alrededor del mejor modelo, en tu computadora.

Topics

Resources

Security policy

Stars

8 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages