SofaBuffers
Structured Objects For Anyone
... so optimized, feels amazing.
SofaBuffers Code Generator — sofabgen
sofabgen — the SofaBuffers code generator. It compiles a message
definition (YAML/JSON) into typed encode/decode wrappers for your target
language. Installing this package puts the sofabgen command on your PATH —
no Go toolchain, no compiler, nothing to build.
Install
As a throwaway tool run, without installing anything permanently:
uvx sofabgen --version
As a standalone CLI:
uv tool install sofabgen # or: pipx install sofabgen
Or pinned into a project's development environment:
pip install sofabgen
Usage
Generate code from a message definition:
sofabgen --lang python --in messages/example.yaml --out src/generated/
Key flags:
--lang <target>— one ofc,cpp,csharp,dart,docs,go,java,kotlin,python,rust,typescript,zig.--in <path>— a message-definition file, or a directory of them.--out <dir>— where the generated code is written.--config <file>— the YAML/JSON config carrying all options.--versionprints the version;--helplists every flag.
Runtime dependency: the corelib
sofabgen is a build-time tool — it emits typed code but never touches wire
bytes itself. The generated code calls into a small per-language runtime
library ("corelib") that owns the wire format. So alongside the generator, your
project needs the corelib for your target language at runtime.
For the Python target that is
sofa-buffers-corelib
(source) — installed under that name,
imported as sofab:
pip install sofa-buffers-corelib
from sofab import Encoder, Decoder
It ships a compiled accelerator in prebuilt wheels, so a normal install gets the
native engine without a C toolchain (sofab.IMPL reports which engine is active).
For any other target language, install that language's corelib in its own ecosystem
(npm, Cargo, Go modules, NuGet, Maven, …).
How the binary is delivered
sofabgen is a single static Go binary. This project publishes one wheel per
platform, each containing nothing but that binary; pip picks the one matching
your host and unpacks it straight onto your PATH. There is no Python code in
the package, no import package, and no build step — pip install sofabgen
downloads exactly one binary and is done.
Supported hosts: Linux (x86-64, x86-32, ARM64, ARMv7 — glibc and musl alike), macOS (Intel and Apple Silicon), Windows (x86-64, x86-32, ARM64). The binaries are the very ones attached to the matching GitHub release, published from that release by a Trusted Publisher with attestations — so the file you install is verifiably the one CI built from the tagged source.
Only wheels are published, deliberately: with a source distribution present, pip on an unsupported platform would try to build from source and fail obscurely instead of telling you there is no matching distribution.
Links
- Source & documentation: https://github.com/sofa-buffers/generator
- Runtime library (Python): https://pypi.org/project/sofa-buffers-corelib/
MIT licensed.
Release files for sofabgen 0.24.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
Total release size: 39.1 MB
Release files / sofabgen-0.24.0-py3-none-win_arm64.whl
| Download URL | sofabgen-0.24.0-py3-none-win_arm64.whl |
|---|---|
| Size | 2.9 MB |
| Tags | Python 3 Windows ARM64 |
|
SHA-256 checksum How to use checksums |
ed5785220125bf9e0da5cf7908e5f3f0921308ba94fd4a93712c0546efe9b629
|
|
BLAKE2b-256 checksum How to use checksums |
a0f60cd46c7a3325650bae3e72ee39ecc1f6b1534fdac27ba907b59c78a066cb
|
| 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 Sep 24, 2026.
Transparency logRelease files / sofabgen-0.24.0-py3-none-win_amd64.whl
| Download URL | sofabgen-0.24.0-py3-none-win_amd64.whl |
|---|---|
| Size | 3.2 MB |
| Tags | Python 3 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
3ad0a86118e6303b592e198e156affb0d95d8aa9052f44f3e3e3e50524a0a07d
|
|
BLAKE2b-256 checksum How to use checksums |
7683b09e343dc6d531e7a07489081b03d27e6cb2e81e148f235f4317c87f7023
|
| 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 Sep 24, 2026.
Transparency logRelease files / sofabgen-0.24.0-py3-none-win32.whl
| Download URL | sofabgen-0.24.0-py3-none-win32.whl |
|---|---|
| Size | 3.1 MB |
| Tags | Python 3 Windows x86-32 |
|
SHA-256 checksum How to use checksums |
c6e2398c7c4b9a12b41d9c13d2b1fc2084be72e8782f2382e04bbebf84150cfe
|
|
BLAKE2b-256 checksum How to use checksums |
895c8c19072ecf74048c9a2abc953b2cb4f7c2767ca987b70820c2f4c49dcc1b
|
| 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 Sep 24, 2026.
Transparency logRelease files / sofabgen-0.24.0-py3-none-musllinux_1_2_x86_64.whl
| Download URL | sofabgen-0.24.0-py3-none-musllinux_1_2_x86_64.whl |
|---|---|
| Size | 3.2 MB |
| Tags | Linux musl 1.2+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
34682d99c338b31238746e1aa2ec800e382a256315ed0b2bf48783c3b02c0f81
|
|
BLAKE2b-256 checksum How to use checksums |
49b8be0c26ed36fc08304019722389e78fc2c06eec44e7b915a347a35f625129
|
| 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 Sep 24, 2026.
Transparency logRelease files / sofabgen-0.24.0-py3-none-musllinux_1_2_i686.whl
| Download URL | sofabgen-0.24.0-py3-none-musllinux_1_2_i686.whl |
|---|---|
| Size | 3.0 MB |
| Tags | Linux musl 1.2+ x86-32 Python 3 |
|
SHA-256 checksum How to use checksums |
8e9a54f3d849dcc894143fccdfe985a601f865727bfeda204b5737bfb0c03e98
|
|
BLAKE2b-256 checksum How to use checksums |
b523d2fc511320d4a124f9c57cde5020350c49892f879602c2893fbde3899259
|
| 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 Sep 24, 2026.
Transparency logRelease files / sofabgen-0.24.0-py3-none-musllinux_1_2_armv7l.whl
| Download URL | sofabgen-0.24.0-py3-none-musllinux_1_2_armv7l.whl |
|---|---|
| Size | 3.0 MB |
| Tags | Linux musl 1.2+ ARMv7l Python 3 |
|
SHA-256 checksum How to use checksums |
d85c895db80f6fe8943d3043063e4eead17fe55f5494f6948e1c5535cbf47d9a
|
|
BLAKE2b-256 checksum How to use checksums |
c51535e6b3f98098f6b25c62d422eb15f1c043638f68f44f9e7dbc8c87ba1dc3
|
| 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 Sep 24, 2026.
Transparency logRelease files / sofabgen-0.24.0-py3-none-musllinux_1_2_aarch64.whl
| Download URL | sofabgen-0.24.0-py3-none-musllinux_1_2_aarch64.whl |
|---|---|
| Size | 2.8 MB |
| Tags | Linux musl 1.2+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
73a02305a6c94042d0c9ab6c2d8c0ecfc04445a3e2e738eec1ff44fb12f8bb91
|
|
BLAKE2b-256 checksum How to use checksums |
4bb74e2f02a59ebf383ec48337a2b50de8c4c7d83fd25317f5e75600c33ffee6
|
| 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 Sep 24, 2026.
Transparency logRelease files / sofabgen-0.24.0-py3-none-manylinux_2_17_x86_64.whl
| Download URL | sofabgen-0.24.0-py3-none-manylinux_2_17_x86_64.whl |
|---|---|
| Size | 3.2 MB |
| Tags | Linux glibc 2.17+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
3404fea74abbd1bdb9c3bd8e3425fc12c48bc1701b2db99783efc7ec5497b663
|
|
BLAKE2b-256 checksum How to use checksums |
085487e73f97d7c5a176ef50375185f23de079af7e9f43669f5094bb49e16457
|
| 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 Sep 24, 2026.
Transparency logRelease files / sofabgen-0.24.0-py3-none-manylinux_2_17_i686.whl
| Download URL | sofabgen-0.24.0-py3-none-manylinux_2_17_i686.whl |
|---|---|
| Size | 3.0 MB |
| Tags | Linux glibc 2.17+ x86-32 Python 3 |
|
SHA-256 checksum How to use checksums |
6ca6d74ea2a2c76d2e2ce2784648197622e93d384eea7b8023e4860a4b10eb73
|
|
BLAKE2b-256 checksum How to use checksums |
5c6bf693d2142539253a7c31f48fd1348f9d24e22a731d70cb6c424fc516416e
|
| 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 Sep 24, 2026.
Transparency logRelease files / sofabgen-0.24.0-py3-none-manylinux_2_17_armv7l.whl
| Download URL | sofabgen-0.24.0-py3-none-manylinux_2_17_armv7l.whl |
|---|---|
| Size | 3.0 MB |
| Tags | Linux glibc 2.17+ ARMv7l Python 3 |
|
SHA-256 checksum How to use checksums |
270b220cc03530bf24c99e0f0b5dfb375d065f5d2dbbe5fe55b7f389fe307f54
|
|
BLAKE2b-256 checksum How to use checksums |
7c1cae105e118d20eae10a6690fd4495fd8212cbf9263c6f6cc5bc0a77878727
|
| 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 Sep 24, 2026.
Transparency logRelease files / sofabgen-0.24.0-py3-none-manylinux_2_17_aarch64.whl
| Download URL | sofabgen-0.24.0-py3-none-manylinux_2_17_aarch64.whl |
|---|---|
| Size | 2.8 MB |
| Tags | Linux glibc 2.17+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
41e03988709a771628ecccac42d730e1d2cacb975123c5b9b8daeba366b39e53
|
|
BLAKE2b-256 checksum How to use checksums |
61ab3c8bdedc013fc63e475cb09121d8091ec919c026ffbd2ffc25b32c8bfa45
|
| 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 Sep 24, 2026.
Transparency logRelease files / sofabgen-0.24.0-py3-none-macosx_11_0_arm64.whl
| Download URL | sofabgen-0.24.0-py3-none-macosx_11_0_arm64.whl |
|---|---|
| Size | 2.9 MB |
| Tags | Python 3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
515fb1f09abb5bffff7ec1e2859a7df128fc2a76f4c0efde3bd676a74b6d2d87
|
|
BLAKE2b-256 checksum How to use checksums |
cb1e595bd8bcc0b18a08d5f14bcc50bf72cfe6bc39088e46fdec1e66ad9148c2
|
| 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 Sep 24, 2026.
Transparency logRelease files / sofabgen-0.24.0-py3-none-macosx_10_9_x86_64.whl
| Download URL | sofabgen-0.24.0-py3-none-macosx_10_9_x86_64.whl |
|---|---|
| Size | 3.2 MB |
| Tags | Python 3 macOS 10.9+ x86-64 |
|
SHA-256 checksum How to use checksums |
02c633fd6783836a42b59cec61b46fed25587880c5dc1b93fa58ca03e9d5a57d
|
|
BLAKE2b-256 checksum How to use checksums |
f38b552411f1b0602d1a962692e62206f9865925dcbdbdbc42b282512d0217f5
|
| 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 Sep 24, 2026.
Transparency log
