{"id":27337,"library":"reddb-cli","title":"RedDB CLI","description":"RedDB is a unified multi-model database SDK for JavaScript/TypeScript that supports document store, key-value, graph, and vector search within a single embedded Rust runtime. Current stable version is 0.1.5 (pre-release). Release cadence is rapid with nightly pre-release builds. Key differentiators: single binary deployment, no external dependencies, multi-model queries across paradigms, and a CLI tool for direct database management. Ships TypeScript definitions. Requires Node.js >=20.","status":"active","version":"0.1.5","language":"javascript","source_language":"en","source_url":"https://github.com/forattini-dev/reddb","tags":["javascript","database","multi-model","vector-search","graph","document-store","key-value","rust","embedded","typescript"],"install":[{"cmd":"npm install reddb-cli","lang":"bash","label":"npm"},{"cmd":"yarn add reddb-cli","lang":"bash","label":"yarn"},{"cmd":"pnpm add reddb-cli","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"ESM-only in Node >=20. CommonJS require will fail.","wrong":"const { createClient } = require('reddb')","symbol":"createClient","correct":"import { createClient } from 'reddb'"},{"note":"Default import is not available. Always use named import.","symbol":"RedDB","correct":"import { RedDB } from 'reddb'"},{"note":"Query is a type only, use type import to avoid runtime errors.","wrong":"import { Query } from 'reddb'","symbol":"Query","correct":"import type { Query } from 'reddb'"}],"quickstart":{"code":"import { createClient } from 'reddb';\nconst client = createClient({ url: process.env.REDDB_URL ?? 'http://localhost:8080' });\nawait client.connect();\nconst db = client.db('mydb');\nawait db.collection('users').insertOne({ name: 'Alice', age: 30 });\nconst user = await db.collection('users').findOne({ name: 'Alice' });\nconsole.log(user);\nawait client.close();","lang":"typescript","description":"Connects to local RedDB server, inserts a document, retrieves it, and closes connection."},"warnings":[{"fix":"Pin to exact version and test upgrades thoroughly.","message":"API not stable under v1.0.0 — methods and signatures may change without major version bump.","severity":"breaking","affected_versions":"<1.0.0"},{"fix":"Upgrade Node.js to 20+.","message":"Node.js <20 is not supported; engine requirement is >=20. Installing on older Node will silently fail at runtime.","severity":"breaking","affected_versions":">=0.1.0"},{"fix":"Replace `new RedDB(config)` with `createClient(config)`.","message":"The default export `RedDB` (as class) is deprecated since v0.1.5-next. Use `createClient` factory function instead.","severity":"deprecated","affected_versions":">=0.1.5-next"},{"fix":"Call `db.collection('vectors').createIndex({ field: 'embedding', type: 'vector' })` first.","message":"Vector search queries require explicit index creation before use; otherwise they return empty results silently.","severity":"gotcha","affected_versions":">=0.1.0"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"fix":"Run `npm install reddb` or `pnpm add reddb`.","cause":"Package not installed or missing from package.json.","error":"ERR_MODULE_NOT_FOUND: Cannot find package 'reddb'"},{"fix":"Change `const { createClient } = require('reddb')` to `import { createClient } from 'reddb'`.","cause":"Using CommonJS `require` instead of ESM `import`.","error":"TypeError: reddb.createClient is not a function"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}