vordbeste

library0.3.5jsnpmunverified

vorDBeste (v0.3.5) is a natural language interface for PostgreSQL and MySQL databases that translates plain English questions into safe, read-only SQL queries. It uses AI providers like Anthropic, OpenRouter, or Ollama to generate SELECT and DESCRIBE statements, with a clarification step before execution to resolve ambiguity. The tool is designed for non-technical users and automatically documents schemas, queries, and insights as markdown files. It runs as a local web app (port 3456) and is read-only by design, with bounded results (limited to 100 rows per query). It is actively developed on GitHub and supports Node.js 18+.

llm-agents database ai-ml web-framework

npm install vordbeste

github ↗package ↗

INSTALL

IMPORT

SIG · VORDBESTE

vordbeste

llm-agentsjavascriptv0.3.5

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–223 runs

build_error

glibc

node 18–223 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

vordbeste

✓ npx vordbeste

✗ require('vordbeste')

This package is a CLI tool, not a library. Run via npx or global install.

default

✓ import vordbeste from 'vordbeste'

There is no programmatic API; the package only exports a CLI.

Install global CLI and launch web UI to interact with database via natural language.

npm install -g vordbeste && vordbeste # Open http://localhost:3456 in your browser # Follow the setup wizard to connect your database and AI provider # Ask: "Show me the top 5 customers by total order amount"

vordbeste --version

Debug

Known issues

breakingRequires Node.js >=18.0.0. Older versions will fail at runtime.

fix

Upgrade Node.js to version 18 or later.

affects: <18.0.0

breakingOnly PostgreSQL and MySQL databases are supported. Other databases (SQLite, MSSQL, etc.) will not connect.

fix

Use a compatible database or run the tool with a supported dialect.

affects: >=0.0.0

gotchaThe AI provider key (Anthropic, OpenRouter) is configured via the web UI and stored locally in ~/.vordbeste. If you move machines, you must reconfigure.

fix

Copy the ~/.vordbeste directory to the new machine, or re-enter keys in the setup page.

affects: >=0.0.0

gotchaAll queries are automatically limited to 100 rows. This may inadvertently restrict answers that require full datasets (e.g., aggregate counts across large tables).

fix

Use the 'LIMIT' command explicitly in your question if you need more rows, but the hard cap is 1000.

affects: >=0.0.0

gotchaThe tool does not execute write operations, but the AI may still generate unsafe SQL if misconfigured. Always review generated queries in the confirmation step.

fix

Keep the read-only mode enabled and do not grant database user write permissions.

affects: >=0.0.0

Errors

Common errors & fixes

Error: Cannot find module 'vordbeste'

The package is not installed globally or locally.

fix

Run 'npm install -g vordbeste' to install it globally.

Error: listen EADDRINUSE :::3456

Port 3456 is already in use by another process.

fix

Stop the other process or use a different port by setting the PORT environment variable (e.g., PORT=3457 vordbeste).

Error: connect ECONNREFUSED 127.0.0.1:3306

MySQL database is not running or connection credentials are wrong.

fix

Ensure your MySQL server is running and the connection string in the setup page is correct.

Error: AI provider request failed: 401 Unauthorized

The API key for Anthropic or OpenRouter is invalid or missing.

fix

Re-enter your API key in the settings page. Make sure it's active and has credits.

Upgrade

Version history

0.3.5latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

42 hits · last 30 days

node