Open Source · MIT License

The Knowledge Operating System

Brainy is the open-source foundation that powers all Soulcraft products, including Workshop. Vector search, graph relationships, and document storage — unified in one simple API.

What is Brainy?

Brainy is a knowledge operating system that combines three types of data intelligence into one simple API:

• Vector Search — Find content by meaning, not just keywords
• Graph Relationships — Connect entities with typed relationships (127 verb types)
• Document Filtering — Query metadata with MongoDB-style operators

This combination — called Triple Intelligence — lets you replace multiple specialized databases (Pinecone + Neo4j + MongoDB) with a single unified system.

Quick Example

import { Brainy, NounType, VerbType } from '@soulcraft/brainy'

const brain = new Brainy()
await brain.init()  // zero config — auto-detects everything

const reactId = await brain.add({
  data: "React — a JavaScript library for building user interfaces",
  type: NounType.Concept,
  metadata: { category: "frontend", year: 2013 }
})

// Triple Intelligence: vector + graph + metadata in one query
const results = await brain.find({
  query: "modern frontend frameworks",       // vector similarity
  where: { year: { greaterThan: 2015 } },         // metadata filter
  connected: { to: reactId, depth: 2 }            // graph traversal
})

Key Features