brains
Self-hosted AI knowledge agent in TypeScript using Bun runtime and MCP protocol.
Ficha actualizada 23 sept 2026, 16:38 · upstream 23 sept 2026, 16:35 · release sin release detectada
Qué es brains
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Brains is a self-hosted AI knowledge agent that reads and writes markdown files stored locally on your machine or server. It allows you to run an intelligent assistant around your own content — notes, posts, pages, images, and profile data all live as markdown in a brain-data folder. The running brain can search its content, update it, expose tools via MCP (Model Context Protocol), and optionally publish a static website from the same source. It is not a hosted SaaS but rather a personal or site-focused AI assistant that you own entirely on your infrastructure.
- Keep all knowledge in markdown files instead of using a hosted app like Notion or Obsidian
- Run a personal AI assistant on your own machine without relying on third-party SaaS platforms
- Connect your brain to Claude Desktop, Cursor, or other MCP clients for tool use and data access
- Publish a static website from the same content that powers your AI assistant
- Customize behavior with plugins when default configurations are insufficient
- Runs entirely on Bun runtime with TypeScript, requiring no Docker or Node.js installation
- Supports MCP protocol for seamless integration with Claude Desktop and Cursor IDE
- Three distinct recipes (headless, personal, professional) that expand the core functionality without changing the architecture
- Content lives in a local brain-data folder while the agent handles indexing, search, and tool invocation
- Built-in browser/passkey authentication for secure MCP client connections
- Currently only supports Bun runtime; no Node.js or other runtimes are supported yet
- No Docker containerization is available — deployment requires manual setup of the local environment
- APIs outside version 0.2 may change before a stable 1.0 release, as indicated by the current alpha status
- The web dashboard and site publishing features are optional and not yet fully integrated into all recipes
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Brains requires Bun >= 1.4.0 to run. Install it via bun install or bunx. Create a brain instance with `brain init mybrain --recipe personal`, then edit `.env` for your AI_API_KEY. Start the agent with `brain start`. For MCP clients, point them at `http://localhost:8080/mcp` (or use OAuth if available). The `brain-data/` folder is created on first run and contains all content indexed by the brain. For fleets or teams, use @rizom/ops for orchestration.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.