Skip to main content

WorkaDB: Embedded PostgreSQL for Mobile and Desktop

WorkaDB embeds PostgreSQL 18.1 directly into your process. No postmaster, no sockets, just a stable C ABI and full SQL semantics across iOS, Android, and desktop.

Why WorkaDB?

PostgreSQL Semantics Everywhere

Use full Postgres SQL features locally with the same behavior you expect on the server.

No Server Process

Embedded, in-process execution without postmaster, TCP listeners, or background workers.

Stable ABI

A minimal C ABI (wepg_*) keeps integrations stable across releases.

Mobile Ready

Deterministic lifecycle and template-based init make it safe for iOS and Android apps.

Quick Start

Clone the repo, build once, and run SQL in-process.

git clone https://github.com/worka-ai/workadb.git
cd workadb/workadb/build
ARCH=arm64 ./build_desktop.sh

# Then in Rust:
engine.exec_sql("CREATE TABLE issues (id INT, title TEXT);")

Bindings

Python, NodeJS, and Java bindings are planned and coming soon.

Perfect For

Local-First Apps

Full Postgres semantics on-device with predictable sync to the server.

Mobile AI Runtimes

Durable storage for agent workflows and tool state on iOS and Android.

Edge Agents

Keep state close to the device without running a database server.

Test Harnesses

Run Postgres-compatible tests without external services.

Build with Postgres everywhere

WorkaDB brings consistent SQL behavior to mobile and desktop with a single embedded library.