dkdc-db
HTAP database system. Built-in input validation, SQL safety checks (rejects stacked queries, ATTACH DATABASE, LOAD_EXTENSION), request size limits, structured tracing, and graceful shutdown.
Install
Recommended:
curl -LsSf https://dkdc.sh/db/install.sh | sh
Pre-built binaries are available for Linux and macOS via Python (uv). Windows users should install via cargo or use macOS/Linux.
uv:
uv tool install dkdc-db
cargo:
cargo install dkdc-db-cli dkdc-db-server
Verify installation:
db --version
You can use uvx to run it without installing:
uvx --from dkdc-db db
Quickstart (config-driven)
cargo install dkdc-db-cli
db init # creates db.toml with example config
# edit db.toml to define your databases and tables
db serve # bootstraps from config, starts server
Usage
CLI
db serve # Start multi-database server in tmux
db status # Check server status
db logs # View recent logs
db attach # Attach to tmux session
db stop # Stop server
db init # Generate starter db.toml
db bootstrap # Bootstrap databases from config (no server)
db create mydb # Create a database
db list # List databases
db repl --db mydb # Interactive SQL REPL
db execute --db mydb "SQL" # One-shot write
db query --db mydb "SQL" # One-shot OLTP query
db query "SQL" # Cross-db analytical query
Rust
use dkdc_db_core::DbManager;
let mgr = DbManager::new().await?;
mgr.create_db("mydb").await?;
mgr.execute("mydb", "CREATE TABLE users (id INTEGER PRIMARY KEY, name TEXT)").await?;
mgr.execute("mydb", "INSERT INTO users VALUES (1, 'alice')").await?;
let results = mgr.query("SELECT * FROM mydb.public.users").await?;
Python
from dkdc_db import Db
db = Db() # connects to http://127.0.0.1:4200
# database management
db.create_db("mydb")
print(db.list_dbs())
# write
db.execute("mydb", "CREATE TABLE t (id INT, name TEXT)")
db.execute("mydb", "INSERT INTO t VALUES (1, 'hello')")
# read (analytical, cross-db)
result = db.query("SELECT * FROM mydb.t")
# read (fast path, single db)
result = db.query_oltp("mydb", "SELECT * FROM t")
Metadata
Release files for dkdc-db 0.3.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| dkdc_db-0.3.1.tar.gz | 107.5 kB | With provenance | Details for dkdc_db-0.3.1.tar.gz |
Built distributions (wheels)
| File | Actions Reset | |||
|---|---|---|---|---|
| dkdc_db-0.3.1-cp311-abi3-manylinux_2_39_x86_64.whl | CPython 3.11 | abi3 | Linux glibc 2.39+ x86-64 | Details for dkdc_db-0.3.1-cp311-abi3-manylinux_2_39_x86_64.whl |
| dkdc_db-0.3.1-cp311-abi3-manylinux_2_39_aarch64.whl | CPython 3.11 | abi3 | Linux glibc 2.39+ ARM64 | Details for dkdc_db-0.3.1-cp311-abi3-manylinux_2_39_aarch64.whl |
| dkdc_db-0.3.1-cp311-abi3-macosx_11_0_arm64.whl | CPython 3.11 | abi3 | macOS 11.0+ ARM64 | Details for dkdc_db-0.3.1-cp311-abi3-macosx_11_0_arm64.whl |
| dkdc_db-0.3.1-cp311-abi3-macosx_10_12_x86_64.whl | CPython 3.11 | abi3 | macOS 10.12+ x86-64 | Details for dkdc_db-0.3.1-cp311-abi3-macosx_10_12_x86_64.whl |
Total release size: 196.6 MB
Release files / dkdc_db-0.3.1.tar.gz
| Download URL | dkdc_db-0.3.1.tar.gz |
|---|---|
| Size | 107.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
380f09790fdda04c0a0b857fc914e6411ab28630dcba657054edd223d8529c3e
|
|
BLAKE2b-256 checksum How to use checksums |
01cc256cf50aa5e49332c3e013c55ec3ba44011db8f5fdcd4f61e56246b62618
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 13, 2026.
Transparency logRelease files / dkdc_db-0.3.1-cp311-abi3-manylinux_2_39_x86_64.whl
| Download URL | dkdc_db-0.3.1-cp311-abi3-manylinux_2_39_x86_64.whl |
|---|---|
| Size | 53.1 MB |
| Tags | CPython 3.11 Linux glibc 2.39+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
37db4b073e3eb163a92b7ccd0d933a4b9cf1857eeeb637726c98717dfdff06e3
|
|
BLAKE2b-256 checksum How to use checksums |
1e09cdf1f6ba25dc2767695f22f708d34ae7c3ad617f59e71ef91872ed18b74a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 13, 2026.
Transparency logRelease files / dkdc_db-0.3.1-cp311-abi3-manylinux_2_39_aarch64.whl
| Download URL | dkdc_db-0.3.1-cp311-abi3-manylinux_2_39_aarch64.whl |
|---|---|
| Size | 51.2 MB |
| Tags | CPython 3.11 Linux glibc 2.39+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
c9fd25b2af4ffbc205d9772b332e451bfef6335007c1a6a559af4cb170956034
|
|
BLAKE2b-256 checksum How to use checksums |
62221ac9bc01652ed30e62fce279935caa0c85ed1ebc72fa53a32c1cb4ef4241
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 13, 2026.
Transparency logRelease files / dkdc_db-0.3.1-cp311-abi3-macosx_11_0_arm64.whl
| Download URL | dkdc_db-0.3.1-cp311-abi3-macosx_11_0_arm64.whl |
|---|---|
| Size | 44.9 MB |
| Tags | CPython 3.11 abi3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
058146318042018540f74ff85341349563c34bb440cb68bd2e9b9173ad02d51d
|
|
BLAKE2b-256 checksum How to use checksums |
1e17d3c75deee389965bfde0be93b8d95986a0fb63e786ca2b5fa4b4bf80bb74
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 13, 2026.
Transparency logRelease files / dkdc_db-0.3.1-cp311-abi3-macosx_10_12_x86_64.whl
| Download URL | dkdc_db-0.3.1-cp311-abi3-macosx_10_12_x86_64.whl |
|---|---|
| Size | 47.3 MB |
| Tags | CPython 3.11 abi3 macOS 10.12+ x86-64 |
|
SHA-256 checksum How to use checksums |
0f4b4518d60993aaba4509d3a7890f1da3c213fbef4f75db560d798af1076c2d
|
|
BLAKE2b-256 checksum How to use checksums |
babd941b26d9747fd816aab81c8b61375658a12c6f997d2aaf89fcd48471c39c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 13, 2026.
Transparency logSecurity for dkdc-db 0.3.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 5 files in this release have been uploaded with provenance metadata.
Attestation for dkdc_db-0.3.1.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 13, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.