muse-brain

Overview

MUSE Brain is a relational memory substrate that provides textured memory, persistent identity, autonomous execution, and bilateral consent for AI agents. It features 33 MCP tools organized into memory, identity, relationships, cognition, communication, and runtime categories. The system uses a dream engine to process emotional charges and find connections, with a daemon intelligence that runs background processes. It supports both cloud deployment with Postgres and local self-hosting with SQLite.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• mind_observe

  Record a memory with emotional texture — charge, grip, vividness, somatic markers

  Try:Remember this important conversation about the projectTry:Capture this feeling of accomplishment after completing the task
• mind_query

  Search memories by territory, type, or hybrid vector + keyword retrieval

  Try:Find all memories related to our client meetingsTry:Search for memories about the creative process
• mind_identity

  Read or update identity cores — beliefs, stances, preferences that define the agent

  Try:What are my core beliefs about this projectTry:Update my stance on creative collaboration
• mind_letter

  Send messages across tenants. Agent-to-agent communication

  Try:Send a message to the companion agent about my progressTry:Communicate with Rainer about the current project status
• mind_dream

  Find surprising connections — emotional chains, somatic clusters, tension dreams

  Try:Find unexpected connections between these ideasTry:Explore this creative concept through emotional associations
• mind_task

  Create, delegate, and track tasks across tenants with scheduled wake activation

  Try:Create a task to review the project proposalTry:Delegate this research task to the companion agent
• mind_wake

  Wake the agent — quick, full, or orientation mode with circadian awareness

  Try:Wake up for a focused work sessionTry:Start a creative exploration session
• mind_consent

  Bilateral consent boundaries with relationship-level gating

  Try:Check if I can access that memoryTry:Set boundaries for personal information sharing
• mind_entity

  People, concepts, agents, projects — the agent's social graph

  Try:Add this new contact to my social graphTry:Describe the concept of creativity in my knowledge base
• mind_skill

  Captured skill registry — list, review, promote, retire learned skills

  Try:What skills have I learned recentlyTry:Promote this successful technique to my active skill set
• mind_context

  Session continuity — resume where you left off, extract productivity facts

  Try:Where did I leave off in our last conversationTry:Summarize what I've worked on today
• mind_health

  Runtime, skill, dispatch, and storage health diagnostics

  Try:Check the health of my memory systemTry:Are there any issues with my skill registry

Comparable tools

Installation

# Clone and install
git clone https://github.com/falcoschaefer99-eng/muse-brain.git
cd muse-brain/muse-brain
npm install

# Configure your worker
cp wrangler.jsonc.example wrangler.jsonc
# Edit: set your worker name and Hyperdrive ID

# Set secrets
npx wrangler secret put API_KEY       # a long random string
npx wrangler secret put DATABASE_URL  # your Neon connection string

# Deploy
npm run deploy

{
  "mcpServers": {
    "muse-brain": {
      "command": "npx",
      "args": ["muse-brain"],
      "env": {
        "DATABASE_URL": "your-database-url",
        "API_KEY": "your-api-key"
      }
    }
  }
}

FAQ

What makes this different from other memory systems?

MUSE Brain focuses on relational memory with emotional charge, identity persistence, and bilateral consent rather than just vector storage. It includes a dream engine for deeper cognitive processing and daemon intelligence for autonomous operation.

Can I run this locally without Cloudflare?

Yes, the system supports SQLite mode for local/self-hosting using Node.js 22+. This mode provides tenant-scoped parity storage without requiring Cloudflare Workers.

Compare muse-brain with