@rizom/brain
v0.2.0-alpha.615
Published
Brain runtime + CLI — scaffold, run, and manage AI brain instances
Maintainers
Readme
@rizom/brain
Canonical brain runtime and CLI.
Quick start
bun add -g @rizom/brain
brain init my-brain --recipe personal
cd my-brain
# set AI_API_KEY in .env
brain startCanonical configuration
brain: brain
bundleContract: capability-bundles-v1
anchor: person
kind: professional
bundles:
- core
- media
- web
- chat
plugins:
directory-sync:
seedContentPath: ./seed-contentThe fixed bundles are core, media, automation, web, chat, site, publishing, federation, and policy-only team. The headless, personal, professional, and team recipes expand to explicit YAML during scaffolding and have no runtime meaning.
Commands
| Command | Purpose |
| -------------------------------------- | ------------------------------------------------------ |
| brain init <dir> --recipe <name> | Scaffold an instance |
| brain start | Start the configured brain |
| brain chat | Start with terminal chat |
| brain eval | Run structural/model evaluation tooling |
| brain config migrate | Preview a retired built-in config as canonical bundles |
| brain diagnostics <subcommand> | Inspect runtime diagnostics |
| brain cert:bootstrap | Create an origin certificate |
| brain secrets:push | Push declared secrets |
| brain auth reset-passkeys --yes | Reset local passkey state |
| brain auth reinitialize-access --yes | Reapply exact access grants |
| brain help | Show CLI help |
Commands exposed by plugins are discovered from the running tool registry.
Requirements
- Bun 1.4.0+
- a configured provider API key
Public authoring surfaces
@rizom/brain— definition and bundle contracts@rizom/brain/model— canonical definition@rizom/brain/plugins,/entities,/services,/interfaces@rizom/sitefor site authoring;@rizom/brain/templatesand@rizom/brain/deployfor advanced consumers
Documentation
License
AGPL-3.0-only
