llmtrim-uniffi

UniFFI bindings over llmtrim-core: one Rust definition, idiomatic in-process bindings for Python, Ruby, Swift and Kotlin. The compression runs natively in the caller's process (no server, no async).

API

A deliberately flat surface over the engine:

fn compress(
    input: String,                 // a provider-shaped request body (JSON)
    provider: Option<Provider>,    // OpenAi | Anthropic | Google, or None to auto-detect
    preset: Option<String>,        // "aggressive" | "agent" | "code" | "rag" | "safe" | …
                                   // None = config from the environment / config file
) -> Result<CompressOutput, LlmtrimError>

CompressOutput carries the compressed request_json, the resolved provider/model, the tokenizer label/exactness, and the before/after/frozen input-token counts. Embedders that need the full rehydration plan or per-stage reports should depend on llmtrim-core directly in Rust.

In-process vs. the proxy

llmtrim has two integration routes:

The proxy (HTTPS_PROXY=127.0.0.1:8788 llmtrim) intercepts your existing traffic and compresses it in flight. Nothing in your code changes, but the client has to route through the proxy and trust its CA.
These bindings compress in your process. You call compress() on the request body, then send the result with your own HTTP client. No proxy, no CA, no env-var setup.

Use the in-process path when the proxy can't run:

Sandboxed / serverless functions where you can't set a process-wide HTTPS_PROXY or run a side process.
Certificate-pinned clients that reject a MITM CA, so the proxy's interception fails.
Anywhere you'd rather not add a network hop or an extra moving part.

It replaces a per-framework adapter: instead of wiring a hook into each SDK, you compress the body once and POST it yourself. Runnable end-to-end examples (compress, then send with your own client) are in examples/.

Python

# Build a self-contained wheel (cdylib + generated glue):
crates/llmtrim-uniffi/scripts/build-wheel.sh --release
pip install target/wheels/llmtrim-*.whl

import llmtrim, json

req = json.dumps({"model": "gpt-4o",
                  "messages": [{"role": "user", "content": "…"}]})
out = llmtrim.compress(req, llmtrim.Provider.OPEN_AI, "aggressive")
print(out.input_tokens_before, "->", out.input_tokens_after)
# send out.request_json to the provider

Why build-wheel.sh and not plain maturin build: maturin's bindings = "uniffi" auto-packaging is sensitive to the maturin↔uniffi version pair. With maturin 1.14 + uniffi 0.31 it builds the native library into the wheel but omits the generated Python glue (empty package __init__.py). The script runs maturin, then injects the freshly generated bindings and repacks the wheel with valid RECORD hashes. Remove it once the auto path packages cleanly.

Ruby / Swift / Kotlin

All targets generate from the same built library, no extra Rust. The generated glue is a build artifact (its checksums are pinned to the library ABI), so it is regenerated per release rather than committed:

crates/llmtrim-uniffi/scripts/generate-bindings.sh out/   # python, ruby, swift, kotlin

Generation needs an unstripped library. Library-mode uniffi-bindgen reads metadata symbols from the cdylib, but the workspace release profile sets strip = true. The script therefore generates from the (unstripped) debug build; the native library you ship can be a stripped cargo build --release -p llmtrim-uniffi cdylib; the glue loads it by name.

Ruby (verified). This is the raw generated binding (module LlmtrimFfi), for a source build with libllmtrim_ffi.so on the load path. The published gem aliases it to Llmtrim (require "llmtrim" then Llmtrim.compress(...)); see packaging/ruby.

require_relative "llmtrim_ffi"
require "json"
out = LlmtrimFfi.compress(
  JSON.generate({model: "gpt-4o", messages: [{role: "user", content: "…"}]}),
  LlmtrimFfi::Provider::OPEN_AI, "aggressive")
puts "#{out.input_tokens_before} -> #{out.input_tokens_after}"

Swift emits llmtrim_ffi.swift + an FFI header and modulemap; Kotlin emits uniffi/.../llmtrim_ffi.kt (which loads the cdylib via JNA). CI compiles and runs a smoke for both: Swift on macOS (swiftc against the modulemap), Kotlin on a JVM (kotlinc + JNA), so a binding break is caught in all four languages (see tests/swift, tests/kotlin and the bindings* jobs in .github/workflows/ci.yml).

Publishable packages

Each ships the compiled engine bundled, so consumers need no Rust toolchain:

Target	Build	Package	Verified
Python (PyPI)	`scripts/build-wheel.sh`	wheel	locally
Ruby (gem)	`scripts/build-gem.sh`	`packaging/ruby/`	locally
Kotlin/JVM (Maven)	`scripts/build-maven.sh`	`packaging/kotlin/`	locally
Swift (SwiftPM)	`scripts/build-xcframework.sh`	`packaging/swift/`	macOS CI only

Each packaging/<lang>/README.md has the usage + publish details.

Download files

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

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

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.

llmtrim-0.13.1-py3-none-win_amd64.whl (8.0 MB view details)

Uploaded Aug 16, 2026 Python 3Windows x86-64

llmtrim-0.13.1-py3-none-manylinux_2_34_x86_64.whl (8.5 MB view details)

Uploaded Aug 16, 2026 Python 3manylinux: glibc 2.34+ x86-64

llmtrim-0.13.1-py3-none-manylinux_2_34_aarch64.whl (8.4 MB view details)

Uploaded Aug 16, 2026 Python 3manylinux: glibc 2.34+ ARM64

llmtrim-0.13.1-py3-none-macosx_11_0_arm64.whl (8.0 MB view details)

Uploaded Aug 16, 2026 Python 3macOS 11.0+ ARM64

llmtrim-0.13.1-py3-none-macosx_10_12_x86_64.whl (7.9 MB view details)

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

File details

Details for the file llmtrim-0.13.1-py3-none-win_amd64.whl.

File metadata

Download URL: llmtrim-0.13.1-py3-none-win_amd64.whl
Upload date: Aug 16, 2026
Size: 8.0 MB
Tags: Python 3, Windows x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for llmtrim-0.13.1-py3-none-win_amd64.whl
Algorithm	Hash digest
SHA256	`c920debbe43c98a7d5507614d44f88afed02e1c43f4eb4143c5cc3f249a96442`
MD5	`772fbde102274cb24344a94d34c326e4`
BLAKE2b-256	`ff39ebfdaf671255dd722a5419f6924420bf44102efe79fae089bad69ad9c8f2`

See more details on using hashes here.

Provenance

The following attestation bundles were made for llmtrim-0.13.1-py3-none-win_amd64.whl:

Publisher: release-bindings.yml on fkiene/llmtrim

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: llmtrim-0.13.1-py3-none-win_amd64.whl
- Subject digest: c920debbe43c98a7d5507614d44f88afed02e1c43f4eb4143c5cc3f249a96442
- Sigstore transparency entry: 2489748673
- Sigstore integration time: Aug 16, 2026
Source repository:
- Permalink: fkiene/llmtrim@46de6fb0c396ba5ecc63cfc502a898929576a07b
- Branch / Tag: refs/tags/v0.13.1
- Owner: https://github.com/fkiene
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release-bindings.yml@46de6fb0c396ba5ecc63cfc502a898929576a07b
- Trigger Event: push

File details

Details for the file llmtrim-0.13.1-py3-none-manylinux_2_34_x86_64.whl.

File metadata

Download URL: llmtrim-0.13.1-py3-none-manylinux_2_34_x86_64.whl
Upload date: Aug 16, 2026
Size: 8.5 MB
Tags: Python 3, manylinux: glibc 2.34+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for llmtrim-0.13.1-py3-none-manylinux_2_34_x86_64.whl
Algorithm	Hash digest
SHA256	`25d892e92d5ee14d2e8fe054054e61139346c6743d16c534156a58ce41175fb5`
MD5	`6ed546815774ee917369444839c53cc6`
BLAKE2b-256	`be105f96e915abf726a1df8e7ae63be3ef133d6d99fc2bbc707acea16d4a587f`

See more details on using hashes here.

Provenance

The following attestation bundles were made for llmtrim-0.13.1-py3-none-manylinux_2_34_x86_64.whl:

Publisher: release-bindings.yml on fkiene/llmtrim

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: llmtrim-0.13.1-py3-none-manylinux_2_34_x86_64.whl
- Subject digest: 25d892e92d5ee14d2e8fe054054e61139346c6743d16c534156a58ce41175fb5
- Sigstore transparency entry: 2489748635
- Sigstore integration time: Aug 16, 2026
Source repository:
- Permalink: fkiene/llmtrim@46de6fb0c396ba5ecc63cfc502a898929576a07b
- Branch / Tag: refs/tags/v0.13.1
- Owner: https://github.com/fkiene
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release-bindings.yml@46de6fb0c396ba5ecc63cfc502a898929576a07b
- Trigger Event: push

File details

Details for the file llmtrim-0.13.1-py3-none-manylinux_2_34_aarch64.whl.

File metadata

Download URL: llmtrim-0.13.1-py3-none-manylinux_2_34_aarch64.whl
Upload date: Aug 16, 2026
Size: 8.4 MB
Tags: Python 3, manylinux: glibc 2.34+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for llmtrim-0.13.1-py3-none-manylinux_2_34_aarch64.whl
Algorithm	Hash digest
SHA256	`2f0cf59308c63ead995a00a143fb9228132391126916b38065e2b5e5ea1be95a`
MD5	`a798fccef6eefa1d2a80363b6a6a2795`
BLAKE2b-256	`dc9ca536e38d5133a5b16472e601a00c26a8a276eff07063e8148bf161ed0049`

See more details on using hashes here.

Provenance

The following attestation bundles were made for llmtrim-0.13.1-py3-none-manylinux_2_34_aarch64.whl:

Publisher: release-bindings.yml on fkiene/llmtrim

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: llmtrim-0.13.1-py3-none-manylinux_2_34_aarch64.whl
- Subject digest: 2f0cf59308c63ead995a00a143fb9228132391126916b38065e2b5e5ea1be95a
- Sigstore transparency entry: 2489748602
- Sigstore integration time: Aug 16, 2026
Source repository:
- Permalink: fkiene/llmtrim@46de6fb0c396ba5ecc63cfc502a898929576a07b
- Branch / Tag: refs/tags/v0.13.1
- Owner: https://github.com/fkiene
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release-bindings.yml@46de6fb0c396ba5ecc63cfc502a898929576a07b
- Trigger Event: push

File details

Details for the file llmtrim-0.13.1-py3-none-macosx_11_0_arm64.whl.

File metadata

Download URL: llmtrim-0.13.1-py3-none-macosx_11_0_arm64.whl
Upload date: Aug 16, 2026
Size: 8.0 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 llmtrim-0.13.1-py3-none-macosx_11_0_arm64.whl
Algorithm	Hash digest
SHA256	`36e40d91fc0c0f7d067114659eab5f4ed245d8f5cdcc883179fbdf810cdcc0f0`
MD5	`262e78a8a02ecc1c1d04ef532c7b12f5`
BLAKE2b-256	`9c219403fa43c09493acfbe31a02238b6e9f26d0f60ff632a27f3833e937cac1`

See more details on using hashes here.

Provenance

The following attestation bundles were made for llmtrim-0.13.1-py3-none-macosx_11_0_arm64.whl:

Publisher: release-bindings.yml on fkiene/llmtrim

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: llmtrim-0.13.1-py3-none-macosx_11_0_arm64.whl
- Subject digest: 36e40d91fc0c0f7d067114659eab5f4ed245d8f5cdcc883179fbdf810cdcc0f0
- Sigstore transparency entry: 2489748657
- Sigstore integration time: Aug 16, 2026
Source repository:
- Permalink: fkiene/llmtrim@46de6fb0c396ba5ecc63cfc502a898929576a07b
- Branch / Tag: refs/tags/v0.13.1
- Owner: https://github.com/fkiene
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release-bindings.yml@46de6fb0c396ba5ecc63cfc502a898929576a07b
- Trigger Event: push

File details

Details for the file llmtrim-0.13.1-py3-none-macosx_10_12_x86_64.whl.

File metadata

Download URL: llmtrim-0.13.1-py3-none-macosx_10_12_x86_64.whl
Upload date: Aug 16, 2026
Size: 7.9 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 llmtrim-0.13.1-py3-none-macosx_10_12_x86_64.whl
Algorithm	Hash digest
SHA256	`c9b35f2b24ba4dc86759897445394554f5bd3af5f3b64d00b6632f237efc7e50`
MD5	`5129dd3c4a744865e7dcbd40962853be`
BLAKE2b-256	`42bc58759b1cbf3a920fe9d2766c56bce7e777515a8e12e2ee35751698fd2753`

See more details on using hashes here.

Provenance

The following attestation bundles were made for llmtrim-0.13.1-py3-none-macosx_10_12_x86_64.whl:

Publisher: release-bindings.yml on fkiene/llmtrim

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: llmtrim-0.13.1-py3-none-macosx_10_12_x86_64.whl
- Subject digest: c9b35f2b24ba4dc86759897445394554f5bd3af5f3b64d00b6632f237efc7e50
- Sigstore transparency entry: 2489748690
- Sigstore integration time: Aug 16, 2026
Source repository:
- Permalink: fkiene/llmtrim@46de6fb0c396ba5ecc63cfc502a898929576a07b
- Branch / Tag: refs/tags/v0.13.1
- Owner: https://github.com/fkiene
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release-bindings.yml@46de6fb0c396ba5ecc63cfc502a898929576a07b
- Trigger Event: push