AxioDB

An embedded database for TypeScript and Node.js that provides advanced queries and ACID safety without running a server.

👉 Official Documentation — axiodb.in: full guides, API reference, and examples. This README is a quick start.

Quick start

npm install axiodb

const { AxioDB } = require('axiodb');

const db = new AxioDB({ GUI: true });          // Dashboard at http://localhost:27018
const users = await (await db.createDB('AppDB')).createCollection('users');

await users.insert({ name: 'Alice', age: 30 });
const { data } = await users.query({ age: { $gt: 25 } }).Sort({ age: -1 }).Limit(10).exec();
console.log(data.documents);

No server to run, no node-gyp, no electron-rebuild. Requires Node.js ≥20 (also verified on Bun v1.4.0).

🤖 AI Agent Skill

Building with Claude Code, Cursor, Copilot, Antigravity, or Windsurf? Install the official AxioDB skill so your AI agent generates verified query syntax, accurate transaction patterns, and avoids hallucinated APIs:

npx skills add nexoral/AxioDB --skill skill

Why AxioDB?

• 📦 Zero Setup & Zero C++: Pure JavaScript and TypeScript. No node-gyp errors, no build tools, and no native compilation issues on Node.js, Bun, or Electron.
• 📄 Native JSON (No SQL Migrations): Store raw objects directly. Perfect for AI agents, chats, and apps where data structures change often and SQL schemas are painful.
• 🛡️ Safe from Crashes & Corruption: Uses real ACID transactions and Write-Ahead Logging (WAL). Even if your app or server crashes mid-write, your data stays intact.
• ⚡ Fast In-Memory Caching: Delivers sub-millisecond (<1ms) reads with a built-in memory cache and fast disk indexes.
• 🤖 AI-Ready: Works out-of-the-box with AI coding assistants (Cursor, Claude Code, Copilot) via our official agent skill.

When to Use It

Great for:

• AI Agent Memory — Save conversation history, tool calls, and agent state locally.
• Desktop & Electron Apps — An embedded database that never breaks on user machines during updates.
• CLI Tools & Local Apps — Save and query data easily without running a database server.
• Fast Prototyping — Build full features with MongoDB-like queries without setting up Docker or cloud DBs.

Best fit: 1,000 to 500,000 documents.

When NOT to use it:

• Millions of records, hundreds of concurrent web connections, or distributed clusters — use PostgreSQL or MongoDB instead. See measured limits.

Features

Core — the embedded engine

• MongoDB-style queries — { age: { $gt: 25 } }, 19 operators, plus .hint() and .findByIds()
• ACID transactions — commit/rollback, savepoints, write-ahead log, crash recovery via Transaction.recoverTransactions()
• Aggregation — 19 stages including $lookup joins, extensible through OperatorRegistry
• Indexes — dual-write memory + disk index, served by a TTL-backed IndexCache
• InMemoryCache — per-instance, invalidated on write, tunable via { Cache, minTTL, maxTTL, cacheClearUp }

Self-hostable server — the same engine, reachable remotely

• Embedded — new AxioDB({...}) in-process, no server, the default
• HTTP API — port 27018, 41 documented endpoints, REST and OpenAPI
• AxioDBCloud (TCP) — port 27019, 32 commands, optional TCPAuth and TLS
• MCP server — port 27020, 45 tools for AI agents, native in core ({ MCP: true }) and Docker
• Docker — theankansaha/axiodb, every surface configurable by environment variable

Clients and apps

• Dashboard — browser UI served by the HTTP surface, for browsing collections and running queries
• AxioDBCloud client — the TypeScript client for the TCP surface, with connection pooling and auto-reconnect
• CLI — Go binary for 12 platforms: interactive REPL, TLS, export/import
• Desktop app — Electron GUI for Linux, macOS, and Windows

Performance & Testing

AxioDB is verified across 14 isolated test suites (329+ tests) with a 100% pass rate, benchmarked at 100,000 documents on an AMD Ryzen 5 5500U / Node v26:

Full performance charts, test suites, and methodology: axiodb.in/performance.

Tooling & Deployment

Desktop GUI & CLI

AxioDB ships an interactive Go CLI and an Electron desktop app for Linux, macOS, and Windows:

# Linux / macOS
curl -fsSL https://raw.githubusercontent.com/nexoral/AxioDB/main/cli/Scripts/install.sh | bash

# Windows (PowerShell)
irm https://raw.githubusercontent.com/nexoral/AxioDB/main/cli/Scripts/install.ps1 | iex

Prebuilt binaries are also available on GitHub Releases.

Docker

docker run -d --name axiodb-server \
  -p 27018:27018 -p 27019:27019 \
  -v axiodb-data:/app \
  theankansaha/axiodb

All surfaces default to on, seeded with an admin account. See Docker/README.md for environment variables and configuration.

Documentation

Contributing, security & license

Contributions are welcome — see CONTRIBUTING.md and CODE_OF_CONDUCT.md.

Security issues: report privately through GitHub Security Advisories. Policy details in SECURITY.md.

Released under the MIT License. Author: Ankan Saha.

Support the project with a ⭐ on GitHub or through GitHub Sponsors.