sochdb-core

Core types and traits for SochDB - the LLM-native database.

Overview

sochdb-core provides the foundational types, error handling, and trait definitions used throughout the SochDB ecosystem. This crate is typically not used directly - instead, use the sochdb client crate.

Features

Core Types: Value types, keys, and serialization primitives
Error Handling: Unified error types across all SochDB crates
Trait Definitions: Common traits for storage backends and query execution
TOON Format: Token-optimized notation for LLM efficiency (40-66% fewer tokens than JSON)

Installation

[dependencies]
sochdb-core = "0.2.5"

Usage

Most users should use the high-level sochdb crate instead:

use sochdb::Database;

let db = Database::open("./my_data")?;

Crate Structure

SochDB is organized into several crates:

Crate	Purpose
`sochdb`	High-level client API (start here)
`sochdb-core`	Core types and traits (this crate)
`sochdb-storage`	Storage engine with WAL
`sochdb-index`	HNSW vector indexing
`sochdb-query`	Query planning and execution

License

Apache-2.0 - see LICENSE for details.