qmvir

QMvir (npm 4.8.x) — Hybrid AI-Native Database combining OLTP + OLAP + Full-text Search + Vector Search + Smart Cache in one platform. Pure Rust engine, zero Python dependency.

Install

# Global CLI (recommended; auto-downloads native Rust binary)
npm install -g qmvir

# Project-local (invoke with npx — see Troubleshooting)
npm install qmvir

# pnpm
pnpm add qmvir

The package auto-downloads the correct native Rust binary (~8–11 MB) for your platform during postinstall.

Troubleshooting: ModuleNotFoundError: No module named 'qm_app'

Your shell is running a different program named qmvir (often /opt/homebrew/bin/qmvir, a Python entrypoint), not the Node launcher from this npm package.

1. Inspect candidates:

   which -a qmvir
   head -5 "$(command -v qmvir)"

   Correct npm launcher starts with #!/usr/bin/env node. If you see from qm_app import …, remove or rename that file, or put npm’s bin earlier in PATH.

2. After npm install -g qmvir, run the real binary by path:

   "$(npm config get prefix)/bin/qmvir" --version

3. If you only ran npm install qmvir (no -g), use:

   npx qmvir --version
   # or: ./node_modules/.bin/qmvir --version

SDK Usage (JavaScript / TypeScript)

import { QMClient } from "qmvir";

const qm = new QMClient("http://localhost:8400", { apiKey: "your-key" });

// CRUD
const users = await qm.find("users", {
  where: { status: "active" },
  orderBy: [{ created_at: "desc" }],
  limit: 10,
});

await qm.insert("users", { name: "Alice", balance: 150.5 });
await qm.update("users", "user-123", { balance: 200.0 });
await qm.delete("users", "user-456");

// Full-text + Vector hybrid search
const results = await qm.search("articles", "machine learning", {
  strategy: "hybrid", // lexical | vector | hybrid | rerank
  limit: 20,
});

// Analytics aggregation
const stats = await qm.aggregate("orders", {
  groupBy: ["region", "category"],
  metrics: [{ total: "SUM(amount)" }, { count: "COUNT(*)" }],
  where: { year: 2026 },
});

CLI Usage

# Start QMvir server (PostgreSQL wire protocol)
qmvir --data-dir ./data start --host 127.0.0.1 --port 55433

# Connect via psql
psql -h 127.0.0.1 -p 55433 -U admin -d qm

# SQL queries
CREATE TABLE users (id INTEGER PRIMARY KEY, name TEXT, balance DOUBLE PRECISION);
INSERT INTO users VALUES (1, 'Alice', 150.50);
SELECT * FROM users WHERE balance > 100;

# Backup & Restore
qmvir --data-dir ./data backup -o backup.qmvb
qmvir --data-dir ./data restore backup.qmvb

# Inspect
qmvir --data-dir ./data inspect --tables
qmvir --data-dir ./data stat --json

Benchmark Results (v4.3.4, VPS Contabo 24GB RAM, Linux x86_64)

| Benchmark | ops/s | Time | |-----------|------:|-----:| | Ring Buffer IPC (1KB) | 266.2K | 15.4 ms | | LSN Sequencer | 190.48M | 525 μs | | B+Tree point lookup | 6.30M | 1.6 ms | | Roaring Bitmap contains | 416.67M | 24 μs | | Bloom Filter lookup | 2.50G | 4 μs | | HNSW search top-10 (128d) | 30.4K | 32.9 ms | | SQL SELECT by PK (e2e) | 753.8K | 6.6 ms | | SQL INSERT (e2e) | 1.1K | 9.39 s | | SQL COUNT(*) aggregation | 574.7K | 174 μs |

Linux production features: io_uring WAL, AVX-512F SIMD, O_DIRECT, madvise, fdatasync.

Supported Platforms

| Platform | Architecture | Binary | Size | | -------- | ------------ | ------ | ---- | | macOS | ARM64 (M1+) | qm-macos-arm64 | 7.4 MB | | Linux | x86_64 | qm-linux-x86_64 | 8.4 MB | | Linux | ARM64 | qm-linux-aarch64 | 6.9 MB |

Windows is not distributed via this npm package; use Docker or build from source on Windows if needed.

Maintainer: Linux qm binaries + npm publish

1. Align crate version (qm_engine/Cargo.toml) with npm/package.json.
2. cd npm && npm run build:linux (requires Docker). Artifacts land in bin/native/qm-linux-x86_64 and qm-linux-aarch64.
3. Upload those two files plus macOS binaries (if publishing them) to virgori/qmvir-releases under tag v<version> — postinstall downloads by tag matching package.json version.
4. cd npm && npm run verify:native && npm publish --access public (needs NPM_TOKEN).

Alternative Install

# Shell script (auto-detect platform)
curl -fsSL https://raw.githubusercontent.com/virgori/qmvir-db/main/install.sh | bash

License

MIT