aresadb 0.1.3

High-performance multi-model database — KV, Graph, Relational, Vector

aresadb

Python bindings for AresaDB — a high-performance multi-model database engine in Rust.

Install

pip install aresadb
# or
uv add aresadb

Quick Start

from aresadb_python import Database

# Create a database
db = Database.create("./mydata", "demo")

# Insert data
user = db.insert("user", '{"name": "Alice", "age": 30}')
print(user.id, user.properties)

# Or use a dict directly
user2 = db.insert_dict("user", {"name": "Bob", "age": 25})

# Query with SQL
result = db.query("SELECT * FROM user WHERE age > 20")
for row in result.rows:
    print(dict(zip(result.columns, row)))

# Get by type
users = db.get_by_type("user")

# Get by ID
node = db.get(user.id)

# Delete
db.delete(user.id)

# Database status
status = db.status()
print(f"Nodes: {status.node_count}, Edges: {status.edge_count}")

Vector Search

# Insert with embedding
doc = db.insert_with_embedding(
    "document",
    '{"title": "ML Intro", "content": "Machine learning is..."}',
    "embedding",
    [0.9, 0.1, 0.0, 0.0]
)

# Similarity search
results = db.similarity_search(
    query_vector=[1.0, 0.0, 0.0, 0.0],
    node_type="document",
    field="embedding",
    k=10,
    metric="cosine"  # cosine, euclidean, dot, manhattan
)
for r in results:
    print(f"Node: {r.node_id}, Score: {r.score:.4f}")

Graph Edges

user = db.insert("user", '{"name": "Alice"}')
order = db.insert("order", '{"amount": 99.99}')

edge_id = db.create_edge(user.id, order.id, "placed")

License

MIT