Skip to main content

SmartKDB – AI-ready embedded database engine with smart indexing and configuration UI

Project description

SmartKDB

SmartKDB is a production-ready, AI-enhanced embedded database engine for Python. It combines the structured data model of SQL with the flexibility of NoSQL, adding a lightweight AI layer for semantic querying and automatic indexing.

Features

  • Hybrid Data Model: Structured tables + JSON documents.
  • AI-Powered:
    • Semantic Querying: db.semantic_query("users", "users older than 25")
    • Auto-Indexing: Automatically detects hot fields and creates indexes.
  • Built-in Management:
    • HTML Dashboard: Manage your DB visually via kdb_config.html.
    • CLI: smartkdb init, smartkdb status, smartkdb shell.
  • Secure: Role-Based Access Control (RBAC) with hashed passwords.
  • Zero Dependencies: Pure Python, runs anywhere.

Installation

pip install smartkdb

Quick Start

1. CLI Usage

Initialize a new database:

smartkdb init mydb.kdb

Check status:

smartkdb status mydb.kdb

2. Python Usage

from kdb import SmartKDB

# Initialize
db = SmartKDB("mydb.kdb")

# Login (Default admin/admin created by CLI init)
db.login("admin", "admin")

# Create Table
users = db.create_table("users", indexes=["age"])

# Insert
users.insert({"name": "Alice", "age": 30, "role": "engineer"})

# Semantic Query
results = db.semantic_query("users", "engineers older than 20")
print(results)

Configuration Dashboard

SmartKDB includes a visual configuration tool.

  1. Locate kdb_config.html in your package installation or download it from the repo.
  2. Open it in your browser.
  3. Point it to your database configuration files (export/import supported).

License

MIT License

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

smartkdb-1.0.0.tar.gz (18.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

smartkdb-1.0.0-py3-none-any.whl (22.5 kB view details)

Uploaded Python 3

File details

Details for the file smartkdb-1.0.0.tar.gz.

File metadata

  • Download URL: smartkdb-1.0.0.tar.gz
  • Upload date:
  • Size: 18.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.5

File hashes

Hashes for smartkdb-1.0.0.tar.gz
Algorithm Hash digest
SHA256 45e07ac8a8f0d477f75125bc6342e0df8bd55ca3b02e051be57bd7b54398847a
MD5 10949bd74b0d1f98480d13bb4b3a7dc4
BLAKE2b-256 ab22400945ccf6927ad93e1105ffab3da590f7018d24e7df5d2a3d9f610b1fa6

See more details on using hashes here.

File details

Details for the file smartkdb-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: smartkdb-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 22.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.5

File hashes

Hashes for smartkdb-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 c02d6f3b5e06b1c18d8576bb8b45585674cc7a9afa414c7ef69205c157c590f2
MD5 c95d9a419f7ffa9cf88e892390b30f43
BLAKE2b-256 8e01739a5fccacf760b73e6627b0b5cf66daa6d4275d25ba69f124fd0109b9a2

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page