Installation¶
Security update: Upgrade to TypeBridge 2.2.5. Its prebuilt distributions
use rustls 0.23.46, which fixes RUSTSEC-2026-0346 through RUSTSEC-2026-0349
and the earlier
RUSTSEC-2026-0285.
Its server image also installs Debian's fixed Bookworm PCRE2 and Perl
packages. The 2.2.5 lockfile moves quinn-proto to 0.11.19 for
RUSTSEC-2026-0338 through RUSTSEC-2026-0342; no prebuilt distribution
includes it.
In 2.2.5, write queries ending in fetch return commit failures instead of
documents for writes that were never stored, and the new
TypeDBClient::execute_classified tells rejected commits from indeterminate
outcomes.
The 2.2.1 post-release notice
records the affected earlier release.
Install the TypeBridge surface used by your application. Python, Node, Rust, C, the CLI, and the server are separate distribution identities backed by the same Rust semantic engine.
TypeDB versions¶
Run the newest supported TypeDB, currently 3.14.0. Supported lines are the measured 3.11–3.14 lines with profile patch floors. General version admission accepts >=3.11.0. Newer lines are admitted with one warning per connection: "not tested or supported by this TypeBridge release". They reuse the newest measured profile and protocol assumptions without a compatibility guarantee. Verified tags, protocol bands, and migration pairs are in TypeDB integration.
| TypeBridge | TypeDB servers | Protocol bands |
|---|---|---|
| 2.3.3 | Admits >=3.11.0; supported lines 3.11–3.14; newer lines warn | 8, 9 (newer lines reuse measured assumptions) |
| 2.3.1–2.3.2 | 3.11–3.14 | 8, 9 (3.14 shares profile typedb-3.13.6/v1) |
| 2.3.0 | 3.11–3.13 | 8, 9 |
| 2.1.0–2.2.6 | 3.11–3.12 | 8, 9 (3.8 and 3.10 removed in 2.1.0) |
| 2.0.0–2.0.2 | 3.8–3.12 | 7, 8, 9 (3.8 and 3.10 with a deprecation notice) |
| 1.5.8–1.5.11 | 3.8–3.12 | 7, 8, 9 |
| 1.5.0–1.5.6 | 3.8.0–3.11 | 7, 8 |
| Older releases | See the changelog |
Python¶
Requirements:
- CPython 3.12–3.14
- TypeDB >=3.11.0 is admitted; supported lines are the measured 3.11–3.14 lines. Connected migrations also enforce the workspace profile floors: 3.12.3+ on 3.12, or 3.13.6+/3.14.0+ and newer lines on the newest profile.
Here, + admits later patches on the same minor line; it does not admit a new minor line.
Or with uv:
The wheel includes the native runtime. Install the optional direct TypeDB driver only if your application calls the driver API itself:
TypeScript / Node¶
The Node 18+ package includes prebuilt native modules for Linux glibc (x64/arm64), macOS (x64/arm64), and Windows (x64/arm64):
Linux musl and other architectures are not prebuilt. See the TypeScript/Node packaging notes before selecting a deployment target.
Rust¶
The TypeBridge Rust SDK requires Rust 1.88+. Releases starting with 2.0.1 are distributed through crates.io:
TypeBridge 2.0.0 predates Cargo distribution and remains available from the exact source/Git revision recorded in its GitHub release.
Follow Rust distribution for generated-crate setup and the historical 2.0.0 Git declaration.
C¶
The 2.2.5 GitHub release provides the ABI 1.6.0 shared runtime, standalone CLI, and generated C example for Ubuntu 24.04 on x86_64 GNU/Linux. Verify the signed archives before installation. C17 and C++17 applications use CMake or pkg-config; application execution does not require Python or Cargo.
Follow the C SDK guide for archive names, generation, linking, and the exact supported runtime matrix.
CLI and code generation¶
The type-bridge command is installed with the Python package:
It validates Split-YAML workspaces, creates and applies migrations, and generates configured Python, TypeScript, Rust, and C projections. Split-YAML workspace generation is the only active model-generation path. A standalone CLI archive for Ubuntu 24.04 x86_64 is also available from the 2.2.5 release.
Server container¶
The standalone V2 query server is published separately:
Production deployments should use the immutable digest recorded in the release notes. Follow the server container guide for platforms, non-root execution, TLS, configuration, and supply-chain verification.
Install the source tree¶
PyO3 0.29 supports the CPython 3.12–3.14 source matrix without a forward- compatibility override. Published wheels retain the abi3-py312 baseline.
For contributor dependencies and all-language checks, continue with Development setup.