Skip to main content

TypeBridge connects typed Python, TypeScript, and Rust applications to TypeDB through one semantic engine.

CI PyPI npm crates.io Documentation MIT license

TypeBridge is a typed application toolkit for TypeDB. A versioned Split-YAML workspace is the schema authority. TypeBridge validates that workspace and generates Python, TypeScript/Node, Rust, and C bindings that share one Rust-owned schema, query, migration, validation, and ORM engine.

One system, four generated SDKs

Surface Generated application API Distribution
Python Value classes, model managers, transactions, direct/remote queries type-bridge
TypeScript / Node Branded values, model managers, native and remote queries @type-bridge/node
Rust Schema-bound create/model types, async CRUD and immutable queries type-bridge
C Generated nominal models, transactions, direct/remote queries Ubuntu 24.04 x86_64 shared runtime
CLI Split-YAML checks, migrations, and all four projections Python package or standalone Linux archive
Server Remote V2 query execution over the same generated contract ghcr.io/ds1sqe/type-bridge-server

TypeBridge preserves TypeDB concepts directly: independent attributes, entities, relations, roles, inheritance, cardinality, ordering, keys, and uniqueness remain typed from schema through hydrated results.

Start from Split-YAML

Install the CLI and Python runtime:

pip install type-bridge

Create typebridge.yaml, a schema-set manifest, and one or more schema fragments. Configure the generated package output in the workspace, then run:

type-bridge --manifest typebridge.yaml schema check
type-bridge --manifest typebridge.yaml schema generate
type-bridge --manifest typebridge.yaml migration make --name initial
type-bridge --manifest typebridge.yaml migration apply --environment development

One generation snapshot writes every configured Python, TypeScript, Rust, and C package. Generated packages privately embed the verified authority used by their managers and direct or remote queries, so ordinary applications never configure or read an external authority JSON. A workspace deploying the optional generic server can additionally configure artifacts.schema-authority.output; the server mounts that generated, source-free artifact instead of compiling YAML or accepting a user-maintained JSON schema.

The generated Python package owns the concise single-type manager:

from app_models import Age, Person, PersonId
from type_bridge import Database

db = Database(address="localhost:1729", database="example")
db.connect()

ada = Person(person_id=PersonId("ada"), age=Age(36))
Person.manager(db).put(ada)
people = Person.manager(db).filter(age__gte=18).all()

Use its package-local query session when a query spans types. Query terminals are coroutines; a script without an event loop wraps the session in blocking:

from type_bridge_core import blocking

session = blocking(Person.query(db))
person = session.exact(Person)
adults = (
    session.query(person)
    .where(person.field(Person.age).gte(Age(18)))
    .rows(limit=100)
)

Continue with the Python quick start, Split-YAML reference, and data guide.

TypeScript / Node

npm install @type-bridge/node

Import application values from the generated package and connection primitives from @type-bridge/node:

import { RustDatabase } from "@type-bridge/node";
import { Age, Person, PersonId } from "./generated/models/index.js";

const db = RustDatabase.connect("localhost:1729", "example", {
  username: "admin",
  password: "password",
});
const ada = Person.create({
  personId: PersonId.create("ada"),
  age: Age.create(36n),
});
Person.manager(db).put(ada);
const people = Person.manager(db).filter({ age__gte: Age.create(18n) }).all();

See the TypeScript/Node guide for generated managers, transactions, and direct/remote queries.

Rust

The same workspace emits a schema-bound Rust crate. The generated SDK uses Rust 1.88+ and the crates.io type-bridge runtime:

[dependencies]
type-bridge = "2"

Follow the Rust client guide for generation, direct execution, transactions, and remote queries.

C

TypeBridge 2.3 ships a C ABI 1.7 shared runtime and standalone CLI for Ubuntu 24.04 on x86_64 GNU/Linux. Generate an application schema package from Split-YAML, then link C17 or C++17 consumers with CMake or pkg-config.

See the C SDK guide for signed archives, installation, generation, and the exact supported matrix.

Documentation

Development

uv sync --extra dev
uv run pytest
./test.sh
./scripts/check.sh all
uv run --extra docs mkdocs build --strict

See DEVELOPMENT.md for repository boundaries and verification.

License

TypeBridge-authored code is MIT licensed. Native artifacts also include third-party TypeDB components under Apache-2.0 and MPL-2.0; exact notices ship with each artifact.

Metadata

Release files for type-bridge 2.3.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for type-bridge 2.3.2
File Size Uploaded Provenance Actions
type_bridge-2.3.2.tar.gz 171.5 kB With provenance Details for type_bridge-2.3.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for type-bridge 2.3.2
File Interpreter ABI Platform Actions
type_bridge-2.3.2-py3-none-any.whl Python 3 none any Details for type_bridge-2.3.2-py3-none-any.whl

Total release size: 392.4 kB

Release files / type_bridge-2.3.2.tar.gz

Download URL type_bridge-2.3.2.tar.gz
Size 171.5 kB
Tags Source
SHA-256 checksum
How to use checksums
3fe0c4b7d2e6426548c60f532d9e03d1b91f5281e00e43a05b1558770bf47b7b
BLAKE2b-256 checksum
How to use checksums
89648ce9756a0d3ce044bf02b56c3766e858ad926db92fc3db28609c0e0e5ea6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.

Transparency log

Release files / type_bridge-2.3.2-py3-none-any.whl

Download URL type_bridge-2.3.2-py3-none-any.whl
Size 220.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
363a3d94ef286c5dbe7a3860466147cff974cb8197567ea6cc9072a298bd797e
BLAKE2b-256 checksum
How to use checksums
b311d1efb0c4b3667eebb6b6427caa4fd9c6f43558af8434e4df8c0a4797e089
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.

Transparency log

Security for type-bridge 2.3.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for type_bridge-2.3.2.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

2.3.2 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page