zeusdb 0.0.3

Ultra-light and blazingly-fast database management system

ZeusDB

Meta

✨ What is ZeusDB?

ZeusDB is a next-generation, high-performance data platform designed for modern analytics, machine learning, and real-time insights. Born out of the need for scalable, intelligent data infrastructure, ZeusDB fuses the power of traditional databases with the flexibility and performance of modern data architectures. It is built for data teams, engineers, and analysts who need low-latency access to complex analytical workflows, without sacrificing ease of use or developer control.

ZeusDB serves as the backbone for demanding applications, offering advanced features such as:

• Vector and structured data support to power hybrid search, recommendation engines, and LLM integrations.

• Real-time analytics with low-latency querying, ideal for dashboards and ML model serving.

• Extensibility and safety through modern languages like Rust and Python, enabling custom logic and high-performance pipelines.

• DevOps-ready deployment across cloud or on-prem, with version-controlled configuration, observability hooks, and minimal operational overhead.

Whether you are building a GenAI backend, managing large-scale time-series data, or architecting a unified analytics layer, ZeusDB gives you the foundation to move fast, at scale, with the flexibility of modular architecture.

📦 Installation

You can install ZeusDB with 'uv' or alternatively using 'pip'.

Recommended (with uv):

uv pip install zeusdb

Alternatively (using pip):

pip install zeusdb

🔧 Environment Variables

ZeusDB respects several environment variables for configuration:

• ZEUSDB_SKIP_VERSION_CHECK=1 - Disable automatic version checking
• CI=1 - Automatically detected in CI/CD environments to disable version checking
• ZEUSDB_OFFLINE_MODE=1 - Disable all network operations during imports

Note: ZeusDB automatically checks for the latest versions of its components and will warn you if updates are available. You can disable this in CI/CD environments by setting CI=1 or ZEUSDB_SKIP_VERSION_CHECK=1.

[ ] ZeusDB Vector Database

Quick Start Example

# Import the vector database module from ZeusDB
from zeusdb import VectorDatabase

# Instantiate the VectorDatabase class
vdb = VectorDatabase()

# Initialize and set up the database resources
index = vdb.create_index_hnsw(dim = 8, space = "cosine", M = 16, ef_construction = 200, expected_size=5)

# Upload vector records
vectors = {
    "doc_001": ([0.1, 0.2, 0.3, 0.1, 0.4, 0.2, 0.6, 0.7], {"author": "Alice"}),
    "doc_002": ([0.9, 0.1, 0.4, 0.2, 0.8, 0.5, 0.3, 0.9], {"author": "Bob"}),
    "doc_003": ([0.11, 0.21, 0.31, 0.15, 0.41, 0.22, 0.61, 0.72], {"author": "Alice"}),
    "doc_004": ([0.85, 0.15, 0.42, 0.27, 0.83, 0.52, 0.33, 0.95], {"author": "Bob"}),
    "doc_005": ([0.12, 0.22, 0.33, 0.13, 0.45, 0.23, 0.65, 0.71], {"author": "Alice"}),
}

for doc_id, (vec, meta) in vectors.items():
    index.add_point(doc_id, vec, metadata=meta)

# Perform a similarity search and print the top 2 results
query_vec = [0.1, 0.2, 0.3, 0.1, 0.4, 0.2, 0.6, 0.7] # Query Vector

# Query with no filter (all documents)
print("\n--- Querying without filter (all documents) ---")
results = index.query(vector=query_vec, filter=None, top_k=2)
for doc_id, score in results:
    print(f"{doc_id} (score={score:.4f})")

Output

--- Querying without filter (all documents) ---
doc_001 (score=0.0000)
doc_003 (score=0.0010)

📄 License

This project is licensed under the Apache License 2.0.