Craft intelligent AI systems with memory, collaboration, and empathy
Open source foundation. Premium capabilities. Built for master craftspeople.
// Install latest Brainy from NPM
import { Brainy, NounType } from '@soulcraft/brainy'
// Zero configuration required!
const brain = new Brainy()
await brain.init()
// 1. Add entities with automatic embeddings
const jsId = await brain.add({
data: "JavaScript is a programming language",
nounType: NounType.Concept,
metadata: { type: "language", year: 1995 }
})
const nodeId = await brain.add({
data: "Node.js runtime environment",
nounType: NounType.Concept,
metadata: { type: "runtime", year: 2009 }
})
// 2. Create relationships
await brain.relate({
from: nodeId,
to: jsId,
type: "executes"
})
// 3. Triple Intelligence™ query (vector + graph + metadata)
const results = await brain.find({
query: "programming languages", // Vector search
where: { year: { $gte: 1990 } }, // Metadata filter
connected: { to: nodeId } // Graph relationships
})
Triple Intelligence™: First database to unify vector similarity (semantic search), graph relationships (connections), and metadata filtering (structured queries) in one API. Replace Pinecone + Neo4j + MongoDB with a single 3.4MB package (24MB runtime).
From foundational KOS to empathetic AI - everything you need to craft intelligent systems
Knowledge Operating System
npm install @soulcraft/brainy
Individual AI Agent Memory
Multi-Agent Collaboration
The Human Interface
Empathy as a Service
Enterprise features for large-scale imports and neural processing
Unified progress reporting with automatic time estimation for long operations
10-100x speedup on repeated entity extraction with intelligent cache invalidation
Multi-factor confidence scores (0-1) for all detected relationships
Understand why relationships were detected with source text and reasoning
100% Backward Compatible • All new features are opt-in
The world's first Triple Intelligence™ database unifying vector, graph, and metadata search in one simple API
Semantic understanding through HNSW-powered embeddings. Find similar content by meaning, not just keywords. <10ms queries with 384D vectors.
Navigate connected knowledge like Neo4j. Build knowledge graphs with 31 noun types × 40 verb types for infinite expressiveness.
MongoDB-style metadata queries with O(log n) performance. Structure your data with categories, tags, and attributes for precise filtering.
Search across all three intelligences simultaneously. Find by meaning, relationships, and metadata in a single powerful query - no joins required.
All three intelligences work offline by default. Fast, private, and secure. Add cloud sync only when you need team collaboration.
Ask questions naturally. Triple Intelligence™ understands context, relationships, and structure to deliver exactly what you need.
Production-ready with blazing fast multi-dimensional queries
Perfect memory across conversations. Vector search for context, graph for relationships, metadata for organization.
Beyond keywords to meaning. Combine vector similarity with metadata filters and relationship traversal.
Smart suggestions using vectors for similarity, graphs for patterns, and facets for personalization.
Connect ideas and entities. Build semantic networks with automatic relationship extraction and AI insights.
Visual search with context. Image embeddings plus metadata tags and relationship mapping.
Audio fingerprints meet social graphs. Find similar tracks, discover through patterns, filter by genre.
Pattern matching across symptoms and research. Connect patient data with medical knowledge graphs.
Real-time anomaly detection. Transaction graphs, behavioral vectors, and pattern recognition.
Shared intelligence across teams. Sync knowledge graphs, share context, collaborate on insights.
One Query. Three Paradigms. Infinite Possibilities.
Now that you've seen what's possible, here's how to build it with actual working CLI commands
$ npm install @soulcraft/brainy
$ npm run brainy:init
✓ Initialized local storage
✓ Created default configuration
✓ Ready to store memories!
$ npm run dev
> Starting application with Brainy...
# Initialize Multi-Dimensional Database
npx brainy init --storage filesystem
# Add data across multiple dimensions (vector, graph, facets)
npx brainy add "Customer feedback about product quality" \
--metadata '{"category":"feedback", "sentiment":"positive", "priority":"high"}'
# Multi-dimensional search across vector, graph, and facets
npx brainy search "product issues" \
--filter '{"category":"feedback", "priority":"high"}' \
--verbs "relates_to,caused_by" \
--depth 2
# AI-powered chat with multi-dimensional context
npx brainy chat "What are the main product quality concerns?"
# Connect to Brain Cloud for AI memory
npx brainy connect
npx brainy cloud --status your-customer-id
Import any data and watch Brainy's AI automatically extract entities, relationships, and insights
// AI-powered Neural Import - Brainy figures out the rest
import { NeuralImport } from '@soulcraft/brainy/cortex'
const neuralImport = new NeuralImport(db)
await neuralImport.neuralImport('./customer-feedback.csv')
// ✓ Automatically extracts 20+ entity types
// ✓ Generates embeddings for semantic search
// ✓ Builds knowledge graph connections
// ✓ Smart confidence scoring
// Import CSV, JSON, or YAML with AI understanding
await neuralImport.neuralImport('./data.json', {
confidenceThreshold: 0.7, // FREE AI extraction
autoApply: true // Auto-add to database
})
// Now query your data with natural language
const insights = await db.chat("What patterns exist in our customer feedback?")
CSV, JSON, YAML with AI extraction
Entities, topics, and relationships extracted
Query your data conversationally
100% Free • No API keys required • Works offline • Your data stays private
Codex, Guild, and Heart powered by cloud infrastructure for team collaboration and cross-device sync
Soulcraft Brainy works 100% offline and free forever. When you're ready for unlimited memory, multi-agent collaboration, and empathy, our premium features provide seamless enhancement.
# Upgrade to premium features
$ npx brainy upgrade studio
# Studio + Codex activated
✓ Connected to Soulcraft Studio
✓ Codex enabled: unlimited memory
✓ 3D graph visualization ready
# Same API, enhanced capabilities
await db.search("insights from agent history", {
codex: true // Access unlimited context
})
Join thousands of developers building multi-dimensional AI applications
Installation: npm install @soulcraft/brainy
Help us keep Soulcraft Brainy free and open source forever
The Soulcraft Ecosystem helps developers craft intelligent AI systems. We're committed to keeping Brainy open source while building premium features (Codex, Guild, Heart) that extend its capabilities. Your sponsorship helps us advance AI memory, collaboration, and empathy for the entire community.
Full-time maintainers & new features
Tutorials, examples, and guides
Support, events, and resources
All sponsors get recognition in our README, priority support, and input on the roadmap.