toondb 0.2.4

ToonDB - LLM-optimized database with native vector search
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66

# toondb

The official Rust SDK for [ToonDB](https://toondb.dev) - an LLM-optimized database with native vector search.

## Features

- 🚀 **Zero-copy reads** - Direct access to memory-mapped data
- 🔍 **Native vector search** - Built-in HNSW index for embeddings
- 📊 **Columnar storage** - Efficient for analytical queries
- 🔒 **Thread-safe** - Safe concurrent access with MVCC

## Quick Start

```rust
use toondb::Database;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Open or create a database
    let db = Database::open("./my_data")?;
    
    // Create a collection for storing documents with embeddings
    let collection = db.create_collection("documents")
        .with_vector_dimension(384)
        .with_hnsw_index()
        .build()?;
    
    // Insert data
    collection.insert(b"doc1")
        .set("title", "Hello World")
        .set_vector(&embedding)?;
    
    // Query with vector similarity
    let results = collection.vector_search(&query_embedding)
        .with_limit(10)
        .execute()?;
    
    Ok(())
}
```

## Installation

Add to your `Cargo.toml`:

```toml
[dependencies]
toondb = "0.1"
```

## SDKs

| Platform | Package | Install |
|----------|---------|---------|
| Rust | [`toondb`](https://crates.io/crates/toondb) | `cargo add toondb` |
| Python | [`toondb-client`](https://pypi.org/project/toondb-client/) | `pip install toondb-client` |
| JavaScript | `toondb-client` | Coming soon |

## Documentation

- [API Reference](https://docs.toondb.dev/api-reference/)
- [Getting Started Guide](https://docs.toondb.dev/getting-started/)
- [Examples](https://github.com/toondb/toondb/tree/main/examples/rust)

## License

Apache-2.0