Platform · Mar 2025 — Apr 2025

Solo Mode

Run CogMem Locally with a Single Database for Privacy and Simplicity

Solo Mode

All CogMem capabilities in a single SurrealDB database — perfect for development, research, and privacy-first deployments.

Services

  • Object Storage
  • Text Search
  • Vector Search

Technologies

  • SurrealDB
  • Python
  • Embedded Database

Software

  • SurrealDB
  • Surrealist
  • Docker

Client

CogMem Open Source

Introduction

Solo Mode allows CogMem to run using SurrealDB only, providing a simpler deployment option compared to the enterprise multi-database setup. All capabilities — object storage, text search, vector search, and graph relationships — are handled by a single database. Perfect for development, research, and privacy-first personal deployments.

Challenges

  • Providing all enterprise capabilities in a single lightweight database.
  • Maintaining API compatibility between solo and enterprise modes.
  • Enabling embedded operation without external server dependencies.
  • Supporting both persistent and in-memory storage options.

Solution

Solo Mode leverages SurrealDB multi-model capabilities to provide object storage, full-text search, vector similarity search, and graph relationships in a single database. The contract-first architecture ensures identical API behavior across modes. Embedded mode uses the SurrealDB Python SDK directly for zero-dependency local operation.

Work Done

Embedded Database

Run with a local file database — no external server or Docker needed.

Full-Text Search

SurrealDB provides full-text search with simulated highlighting.

Vector Search

Cosine similarity search for embeddings within SurrealDB.

Graph Relationships

RELATE edges for entity relationships without Neo4j.

Privacy First

All data stays on your device with no cloud dependency.

API Compatible

All endpoints work identically in solo and enterprise modes.

Ready to Build Smarter Knowledge Systems?

Get started with CogMem and transform how your AI agents remember, organize, and evolve knowledge.

Get Started

Contact Us

Get in Touch

Have questions about CogMem? We'd love to hear from you.

Website

cogmem.ai