Soulcraft · Developer Docs

Build with the Soulcraft platform.

Two products power every Soulcraft app and every external integration — Brainy, the open-source knowledge graph, and Cortex, the native Rust accelerator that scales it to billions on commodity hardware. Same code. Same files. Same API.

Jump into Brainy

Brainy is where most developers start. It's MIT-licensed, runs on its own, and ships with everything you need to build a real knowledge graph.

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

example.js
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 Brainy Features

Zero Config

Auto-detects storage, embeddings, and indexes. Just install and use.

Git-Style Versioning

Fork, commit, and time-travel your data. No other vector DB has this.

Native Performance

Rust-powered HNSW, SIMD, and GPU acceleration on Node.js 22+ and Bun 1.3+.

MIT Licensed

Free forever. No vendor lock-in. Self-host or use our cloud.

Jump into Cortex

Cortex is the native Rust accelerator. Same Brainy code, same files, same API — orders of magnitude faster on vector search, aggregation, and large graph traversals at billion-scale.