hoodiecollin-forgedb

An application-database generator. Write one schema; get a tailored database.

forgedb.dev · Getting Started · Docs · Benchmarks

What it is

ForgeDB compiles a declarative .forge schema — at compile time — into a tailored Rust database, a REST API (with an OpenAPI 3.1 spec), and typed clients for TypeScript, Python, Rust, and Go. It is a code generator, not an ORM or query engine: your schema is a compile-time input to generation, never a runtime input to a generic engine. The generated code is specialized per schema over columnar storage, so there is no generic-runtime layer to pay for — nothing reflects your schema at runtime.

Everything in this repository is open source under MIT OR Apache-2.0. See docs/OPEN_CORE.md for the open-core boundary.

Status: early development (0.2.x, pre-1.0), not yet production-ready. What v1 actually guarantees — and what it defers — is stated plainly in docs/WHAT_V1_IS.md. Trust that over any headline here.

One schema in, a stack out

User {
  id: +uuid                                              // auto-generated primary key
  email: ^&string @pattern("^[^@]+@[^@]+\\.[a-z]{2,}$")  // unique, indexed, format-checked
  username: ^&string                                     // unique, indexed
  created_at: ^timestamp                                 // indexed (ordered → range queries)
  posts: [Post]                                          // one-to-many

  @index(created_at, username)                           // composite index
}

Post {
  id: +uuid
  title: ^string @length(5, 200)                         // indexed; length-validated
  author: *User                                          // required foreign key
  view_count: ^u64                                       // indexed (ordered → range queries)
  created_at: ^timestamp
  tags: [Tag]                                            // many-to-many

  @index(author, created_at)                             // composite index
}

Tag {
  id: +uuid
  name: ^&string
  posts: [Post]                                          // many-to-many (bidirectional)
}

forgedb generate turns that into typed, schema-tailored methods — index probes, not scans, and no runtime engine to interpret the schema (these are the real generated signatures; probes return plain values, not a Result):

let ada     = db.user.get_by_email("ada@example.com");    // Option<User> — O(1) unique lookup
let popular = db.post.find_by_view_count_range(            // Vec<Post> — ordered range / top-N
                  Some(1_000), None, /* descending */ true, /* limit */ Some(10));
let recent  = db.post.find_by_author_and_created_at(author_id, ts);  // Vec<Post> — composite index
db.link_post_tag(post_id, tag_id);                        // many-to-many link

— plus a REST endpoint per model with filter/sort/pagination, the OpenAPI spec, and matching typed clients for TypeScript, Python, Rust, and Go (same methods, same shapes, no hand-written HTTP and no drift between them).

How it works

schema.forge
    │  parser (lexer → AST) → validation
    ▼
codegen
    ├─→ Rust database code      (columnar storage, typed query API, durable writes)
    ├─→ REST API (axum)         (CRUD, relation traversal, query params)
    ├─→ OpenAPI 3.1 spec
    ├─→ typed REST clients      (TypeScript, Python, Rust, Go — one per language)
    ├─→ in-process bindings     (PyO3, NAPI-RS — embed the DB instead of calling it, opt-in)
    ├─→ browser read-replica    (WASM, opt-in — the same generated engine, in a Worker)
    └─→ migration transformer   (offline, per-version data rewrite)

The storage is a columnar hybrid: fixed-size types (u64, f64, uuid, …) live in packed columns for tight, cache-friendly access; variable-length data (strings, json) rides an append-only column with an offset index. Because the generated code is monomorphized to your exact schema, there is no dynamic dispatch over a generic row type. Performance is measured, not asserted, and benchmarked fairly — with durability semantics matched across engines. At the fsync-barrier tier ForgeDB ties SQLite and redb; relaxed, it's the fastest of the group, with the smallest on-disk footprint of the embedded four. The methodology and current numbers live in docs/BENCHMARKS.md.

What's real today

Implemented and working:

Schema parser (lexer → AST) + validation; the forgedb CLI
Columnar storage engine, WAL, in-process compaction
Crash-safe durable writes; MVCC transactions + multi-process write coordination
Codegen: Rust database, REST API (+ OpenAPI 3.1), typed REST clients for TypeScript / Python / Rust / Go
Secondary + composite indexes, relation traversal, snapshot reads, live queries, backup/restore
Multi-tenancy (verify-only JWT), schema migrations, browser read-replica (WASM)
LSP server + VS Code extension; in-process native bindings (PyO3 for Python, NAPI-RS for Node / Bun)

Not built (and not near-term): generated UI components. The schema can reference UI components as contract markers, but ForgeDB does not generate component code today.

For the full, honest scope see docs/WHAT_V1_IS.md and docs/V1_ROADMAP.md.

Why generate instead of run an engine

One source of truth. The schema defines storage layout, the Rust database, the TS types, and the API — they cannot drift, because they are all generated from it.
Compile-time, not runtime. Errors surface at build time; the compiler optimizes for your schema rather than a generic one.
No runtime engine to interpret your schema. Generated code links only schema-agnostic substrate crates (storage, WAL, types); there is no ORM reflecting over a schema at runtime.
Columnar from the start. Not a row store with columns bolted on.

Good fit: type-safe full-stack apps with stable schemas, local-first apps (browser read-replica), embedded use where the schema is known at compile time, services that want strong contracts. Poor fit: schemas that change shape at runtime, or ad-hoc analytics over unknown schemas.

Getting started

Install the CLI (macOS / Linux — Windows via WSL2), then scaffold a project:

curl -fsSL https://get.forgedb.dev/install.sh | sh   # prebuilt binary, no Rust toolchain

forgedb init my-app
cd my-app
# edit schema.forge, then:
forgedb dev                    # generate, build, and run the dev server

The same binary is on every major channel — Homebrew, npm, pip/uv, Docker, Nix, and cargo install forgedb. See docs/INSTALL.md for every path.

Or generate from a schema in a cloned checkout:

git clone https://github.com/hoodiecollin/forgedb && cd forgedb
cargo build --workspace
cargo run -- generate all --output ./generated   # discovers ./schema.forge

See docs/GETTING_STARTED.md for the full loop with verified output, docs/INSTALL.md for every install path, and examples/ for worked schemas across many domains.

Documentation

The full docs — with an ecosystem toggle for TypeScript / Python / Rust / Go — are hosted at forgedb.dev/docs. The Markdown sources below are the same content.

Start here

Getting Started — install → scaffold → generate → build → serve
Schema Language Reference — the complete, parser-verified .forge reference
What v1 Is — and Isn't — honest guarantees and limits
Installing — every install path + the substrate version matrix

Operating

Deployment — containers, env config, ops routes, multi-tenancy, JWT
Migrations — how schema changes affect data at rest
Upgrading — what each release requires you to do, newest first
Versioning & Stability — the compatibility policy across surfaces
Benchmarks — measured performance + methodology

Internals & contributing

Architecture — system design and design decisions
Public Crates — the schema-agnostic substrate crates
Contributing · Development · Publishing

Contributing

Contributions are welcome — bug fixes, tests, docs, examples, and performance work especially. Start with the Contributing Guide. Design proposals are filed as design gate issues, not committed docs.

Issues: https://github.com/hoodiecollin/forgedb/issues
Discussions: https://github.com/hoodiecollin/forgedb/discussions

License

Dual-licensed under MIT or Apache 2.0 at your option.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

hoodiecollin_forgedb-0.4.1.tar.gz (3.7 MB view details)

Uploaded Aug 13, 2026 Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

hoodiecollin_forgedb-0.4.1-py3-none-musllinux_1_2_x86_64.whl (4.3 MB view details)

Uploaded Aug 13, 2026 Python 3musllinux: musl 1.2+ x86-64

hoodiecollin_forgedb-0.4.1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (4.2 MB view details)

Uploaded Aug 13, 2026 Python 3manylinux: glibc 2.17+ x86-64

hoodiecollin_forgedb-0.4.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (3.9 MB view details)

Uploaded Aug 13, 2026 Python 3manylinux: glibc 2.17+ ARM64

hoodiecollin_forgedb-0.4.1-py3-none-macosx_11_0_arm64.whl (3.9 MB view details)

Uploaded Aug 13, 2026 Python 3macOS 11.0+ ARM64

hoodiecollin_forgedb-0.4.1-py3-none-macosx_10_12_x86_64.whl (4.1 MB view details)

Uploaded Aug 13, 2026 Python 3macOS 10.12+ x86-64

File details

Details for the file hoodiecollin_forgedb-0.4.1.tar.gz.

File metadata

Download URL: hoodiecollin_forgedb-0.4.1.tar.gz
Upload date: Aug 13, 2026
Size: 3.7 MB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for hoodiecollin_forgedb-0.4.1.tar.gz
Algorithm	Hash digest
SHA256	`f4116805af0a85af53f4e0c656c282b23b7ebea89051d6bb5216005f8c35003e`
MD5	`5bf1925f117ed3741162c7c6456f3e9b`
BLAKE2b-256	`4e80499b5a9ba1285b6cc9c75ac1b852e83bb188c72c8b4959edcbb059267117`

See more details on using hashes here.

Provenance

The following attestation bundles were made for hoodiecollin_forgedb-0.4.1.tar.gz:

Publisher: pypi.yml on hoodiecollin/forgedb

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: hoodiecollin_forgedb-0.4.1.tar.gz
- Subject digest: f4116805af0a85af53f4e0c656c282b23b7ebea89051d6bb5216005f8c35003e
- Sigstore transparency entry: 2453437239
- Sigstore integration time: Aug 13, 2026
Source repository:
- Permalink: hoodiecollin/forgedb@02aae716d175337292f91c75f669742b3b5e5aba
- Branch / Tag: refs/tags/v0.4.1
- Owner: https://github.com/hoodiecollin
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: pypi.yml@02aae716d175337292f91c75f669742b3b5e5aba
- Trigger Event: push

File details

Details for the file hoodiecollin_forgedb-0.4.1-py3-none-musllinux_1_2_x86_64.whl.

File metadata

Download URL: hoodiecollin_forgedb-0.4.1-py3-none-musllinux_1_2_x86_64.whl
Upload date: Aug 13, 2026
Size: 4.3 MB
Tags: Python 3, musllinux: musl 1.2+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for hoodiecollin_forgedb-0.4.1-py3-none-musllinux_1_2_x86_64.whl
Algorithm	Hash digest
SHA256	`5c486659fd5a8e9201811ac2f39ed1106cbd776cdcc04157cf4cc477cc80979e`
MD5	`7c5f849ec692c06e16920332af78753d`
BLAKE2b-256	`172f389e7f4b9959bbc7bc6eb144c30177ef3638d35045cac538120d45aa9445`

See more details on using hashes here.

Provenance

The following attestation bundles were made for hoodiecollin_forgedb-0.4.1-py3-none-musllinux_1_2_x86_64.whl:

Publisher: pypi.yml on hoodiecollin/forgedb

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: hoodiecollin_forgedb-0.4.1-py3-none-musllinux_1_2_x86_64.whl
- Subject digest: 5c486659fd5a8e9201811ac2f39ed1106cbd776cdcc04157cf4cc477cc80979e
- Sigstore transparency entry: 2453437519
- Sigstore integration time: Aug 13, 2026
Source repository:
- Permalink: hoodiecollin/forgedb@02aae716d175337292f91c75f669742b3b5e5aba
- Branch / Tag: refs/tags/v0.4.1
- Owner: https://github.com/hoodiecollin
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: pypi.yml@02aae716d175337292f91c75f669742b3b5e5aba
- Trigger Event: push

File details

Details for the file hoodiecollin_forgedb-0.4.1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

Download URL: hoodiecollin_forgedb-0.4.1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Upload date: Aug 13, 2026
Size: 4.2 MB
Tags: Python 3, manylinux: glibc 2.17+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for hoodiecollin_forgedb-0.4.1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm	Hash digest
SHA256	`f1c58f5f42b33cb775154c4b22a6c2c4d78988fbc233877fabd12750974dd6e1`
MD5	`f178f051ca4681c475f922d94becfbe4`
BLAKE2b-256	`51bf1782c5a1f15c5d310115d42f3fa1c246ce47015c2cd30d306e1771cdf40b`

See more details on using hashes here.

Provenance

The following attestation bundles were made for hoodiecollin_forgedb-0.4.1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: pypi.yml on hoodiecollin/forgedb

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: hoodiecollin_forgedb-0.4.1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
- Subject digest: f1c58f5f42b33cb775154c4b22a6c2c4d78988fbc233877fabd12750974dd6e1
- Sigstore transparency entry: 2453437466
- Sigstore integration time: Aug 13, 2026
Source repository:
- Permalink: hoodiecollin/forgedb@02aae716d175337292f91c75f669742b3b5e5aba
- Branch / Tag: refs/tags/v0.4.1
- Owner: https://github.com/hoodiecollin
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: pypi.yml@02aae716d175337292f91c75f669742b3b5e5aba
- Trigger Event: push

File details

Details for the file hoodiecollin_forgedb-0.4.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

Download URL: hoodiecollin_forgedb-0.4.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Upload date: Aug 13, 2026
Size: 3.9 MB
Tags: Python 3, manylinux: glibc 2.17+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for hoodiecollin_forgedb-0.4.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm	Hash digest
SHA256	`bd7275d1bb626bd46ec41da27ccd22874896aaada56cd0e02fb13e64439e8f1a`
MD5	`7a0d0822fc14fdcdb53b5f8d41a79f97`
BLAKE2b-256	`6c2db318e8e46fdf3d65ce17ed6d150c702eeebeb25a9ca920a62529614f2425`

See more details on using hashes here.

Provenance

The following attestation bundles were made for hoodiecollin_forgedb-0.4.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl:

Publisher: pypi.yml on hoodiecollin/forgedb

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: hoodiecollin_forgedb-0.4.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
- Subject digest: bd7275d1bb626bd46ec41da27ccd22874896aaada56cd0e02fb13e64439e8f1a
- Sigstore transparency entry: 2453437345
- Sigstore integration time: Aug 13, 2026
Source repository:
- Permalink: hoodiecollin/forgedb@02aae716d175337292f91c75f669742b3b5e5aba
- Branch / Tag: refs/tags/v0.4.1
- Owner: https://github.com/hoodiecollin
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: pypi.yml@02aae716d175337292f91c75f669742b3b5e5aba
- Trigger Event: push

File details

Details for the file hoodiecollin_forgedb-0.4.1-py3-none-macosx_11_0_arm64.whl.

File metadata

Download URL: hoodiecollin_forgedb-0.4.1-py3-none-macosx_11_0_arm64.whl
Upload date: Aug 13, 2026
Size: 3.9 MB
Tags: Python 3, macOS 11.0+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for hoodiecollin_forgedb-0.4.1-py3-none-macosx_11_0_arm64.whl
Algorithm	Hash digest
SHA256	`ebabd2408fd40fe84cd88c215bd5d7fb70acedf3c77199958dec9569cec9a7af`
MD5	`a989946985037cf86175b58dd48c4817`
BLAKE2b-256	`4f2c927a171080fa41812b75634e00067d1f0f4a53a02d3c9eb0657689fb3174`

See more details on using hashes here.

Provenance

The following attestation bundles were made for hoodiecollin_forgedb-0.4.1-py3-none-macosx_11_0_arm64.whl:

Publisher: pypi.yml on hoodiecollin/forgedb

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: hoodiecollin_forgedb-0.4.1-py3-none-macosx_11_0_arm64.whl
- Subject digest: ebabd2408fd40fe84cd88c215bd5d7fb70acedf3c77199958dec9569cec9a7af
- Sigstore transparency entry: 2453437405
- Sigstore integration time: Aug 13, 2026
Source repository:
- Permalink: hoodiecollin/forgedb@02aae716d175337292f91c75f669742b3b5e5aba
- Branch / Tag: refs/tags/v0.4.1
- Owner: https://github.com/hoodiecollin
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: pypi.yml@02aae716d175337292f91c75f669742b3b5e5aba
- Trigger Event: push

File details

Details for the file hoodiecollin_forgedb-0.4.1-py3-none-macosx_10_12_x86_64.whl.

File metadata

Download URL: hoodiecollin_forgedb-0.4.1-py3-none-macosx_10_12_x86_64.whl
Upload date: Aug 13, 2026
Size: 4.1 MB
Tags: Python 3, macOS 10.12+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for hoodiecollin_forgedb-0.4.1-py3-none-macosx_10_12_x86_64.whl
Algorithm	Hash digest
SHA256	`f2f035147dbc99a756d959a030db3cf95fccf20e1c7c511c53066c8c817fe63e`
MD5	`28dc5b7f041758243f1950ff7b9c09b9`
BLAKE2b-256	`3dd109413588caed9fba7cf87e28b703421d8f8f99ea5bac886b828e0c83a439`

See more details on using hashes here.

Provenance

The following attestation bundles were made for hoodiecollin_forgedb-0.4.1-py3-none-macosx_10_12_x86_64.whl:

Publisher: pypi.yml on hoodiecollin/forgedb

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: hoodiecollin_forgedb-0.4.1-py3-none-macosx_10_12_x86_64.whl
- Subject digest: f2f035147dbc99a756d959a030db3cf95fccf20e1c7c511c53066c8c817fe63e
- Sigstore transparency entry: 2453437291
- Sigstore integration time: Aug 13, 2026
Source repository:
- Permalink: hoodiecollin/forgedb@02aae716d175337292f91c75f669742b3b5e5aba
- Branch / Tag: refs/tags/v0.4.1
- Owner: https://github.com/hoodiecollin
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: pypi.yml@02aae716d175337292f91c75f669742b3b5e5aba
- Trigger Event: push

Release history Release notifications | RSS feed

0.5.0

Aug 26, 2026 6 files

This release

0.4.1 This release

Aug 13, 2026 6 files

Aug 12, 2026 6 files

Aug 6, 2026 6 files

Aug 1, 2026 6 files

Jul 31, 2026 6 files

Jul 28, 2026 6 files

hoodiecollin-forgedb 0.4.1

What it is

One schema in, a stack out

How it works

What's real today

Why generate instead of run an engine

Getting started

Documentation

Contributing

License

Project links

Key dates

1 maintainer

Credits

GitHub Statistics

License

Requires

Tags

Classifiers

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

Release history Release notifications | RSS feed