Skip to main content

SolidSKeleton Python

Python 3.10+.

pip install ssk

Commands

ssk validate model.ssk
ssk convert model.ssk model.sskb
ssk convert model.ssk model.glb
ssk convert model.ssk model.glb --resolution 64
ssk convert model.sskb model.glb
ssk convert model.glb model.ssk
ssk convert model.glb model.sskb --expected-piece-count 42
ssk inspect model.sskb

From this directory without installing:

python -m ssk validate model.ssk

Library

from ssklib import convert, inspect_file, load, validate_file

convert("model.ssk", "model.glb", resolution=64)
result = convert("model.glb", "model.ssk", expected_piece_count=42)
print(result.coverage_percent, result.overfill_percent)

Lower-level GLTF import:

from ssklib import import_gltf_to_ssk

result = import_gltf_to_ssk(
    "model.glb",
    expected_piece_count=42,  # soft guide
    infill_weight=1.18,
    outfill_weight=1.05,
    complexity_weight=1.0,
)
print(result.coverage_percent, result.overfill_percent)

quality = result.score_document(some_doc)

Lower-level functions:

from ssklib import parse_ssk, parse_sskb, resolve, validate, write_glb, write_gltf, write_ssk, write_sskb

Notes

  • Mesh output defaults to resolution 32.
  • GLTF/GLB import reconstructs (estimated) SSK-native primitives where practical and reports sampled volume coverage and overfill percentages. expected_piece_count / --expected-piece-count is a soft guide, not an exact target. Import weight options (--infill-weight, --outfill-weight, --complexity-weight) tune the scoring between candidates on a normalised 0–1 scale.
  • glTF output uses unindexed meshes with flat per-face normals.

Metadata

Release files for ssk 1.5.0

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

Source distribution (sdist)

Source distribution for ssk 1.5.0
File Size Uploaded
ssk-1.5.0.tar.gz 46.8 kB Details

Built distributions (wheels)

Table of built distributions (wheels) for ssk 1.5.0
File
ssk-1.5.0-cp310-abi3-win_amd64.whl CPython 3.10 abi3 Windows x86-64 Details
ssk-1.5.0-cp310-abi3-manylinux_2_28_x86_64.whl CPython 3.10 abi3 Linux glibc 2.28+ x86-64 Details
ssk-1.5.0-cp310-abi3-manylinux_2_28_aarch64.whl CPython 3.10 abi3 Linux glibc 2.28+ ARM64 Details
ssk-1.5.0-cp310-abi3-macosx_11_0_x86_64.whl CPython 3.10 abi3 macOS 11.0+ x86-64 Details
ssk-1.5.0-cp310-abi3-macosx_11_0_arm64.whl CPython 3.10 abi3 macOS 11.0+ ARM64 Details

Total release size: 3.4 MB

Release files / ssk-1.5.0.tar.gz

Download URL ssk-1.5.0.tar.gz
Size 46.8 kB
Tags Source
SHA-256 checksum
How to use checksums
3a8bf648aa6c0904741a8289bd0d12c50257027589182e42660a03c285e3a95d
BLAKE2b-256 checksum
How to use checksums
3ba4a041d27f47f69dd1cea3cc5b81f6e05a86be50abc9a36d14073802c471b3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

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 Jun 26, 2026.

Transparency log

Release files / ssk-1.5.0-cp310-abi3-win_amd64.whl

Download URL ssk-1.5.0-cp310-abi3-win_amd64.whl
Size 405.5 kB
Tags CPython 3.10 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
09a31ed3103a46659314d497be06b67ad5e3b2c5a354b7db2ec7aa358a00018c
BLAKE2b-256 checksum
How to use checksums
166b29a92f6bf72ce3d106015ce5443d062c7e44e5d3d1183604bce858de2a06
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

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 Jun 26, 2026.

Transparency log

Release files / ssk-1.5.0-cp310-abi3-manylinux_2_28_x86_64.whl

Download URL ssk-1.5.0-cp310-abi3-manylinux_2_28_x86_64.whl
Size 1.1 MB
Tags CPython 3.10 Linux glibc 2.28+ x86-64 abi3
SHA-256 checksum
How to use checksums
8e4d384fb7f4420c5a03aed377d04044434e059ce6262afb649565d3002958bb
BLAKE2b-256 checksum
How to use checksums
453a64f930a0b321cbabf6ba9cf5d13da09e7446893ac0fe039b03c469fe86db
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

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 Jun 26, 2026.

Transparency log

Release files / ssk-1.5.0-cp310-abi3-manylinux_2_28_aarch64.whl

Download URL ssk-1.5.0-cp310-abi3-manylinux_2_28_aarch64.whl
Size 1.0 MB
Tags CPython 3.10 Linux glibc 2.28+ ARM64 abi3
SHA-256 checksum
How to use checksums
b927eceaf6648e1d1c79d347a16e61bd435183e5e389897e3d084803531ad700
BLAKE2b-256 checksum
How to use checksums
f70ad31ce023230528ef65a1b79dfe50a03ebae0cff6c1d559b9b9a3588dcbae
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

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 Jun 26, 2026.

Transparency log

Release files / ssk-1.5.0-cp310-abi3-macosx_11_0_x86_64.whl

Download URL ssk-1.5.0-cp310-abi3-macosx_11_0_x86_64.whl
Size 346.7 kB
Tags CPython 3.10 abi3 macOS 11.0+ x86-64
SHA-256 checksum
How to use checksums
0eb08246c833585343cff34e385164780158e3d7d6722c6f2733eda8bce69b68
BLAKE2b-256 checksum
How to use checksums
2824faeb66bb391d73843dee45c34cb92f695ff4c0980b433d2a8f133dcc2673
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

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 Jun 26, 2026.

Transparency log

Release files / ssk-1.5.0-cp310-abi3-macosx_11_0_arm64.whl

Download URL ssk-1.5.0-cp310-abi3-macosx_11_0_arm64.whl
Size 495.6 kB
Tags CPython 3.10 abi3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
4930c871f44bf295766ec4daf9a3154eefe517831cfd040596abbffc6a194433
BLAKE2b-256 checksum
How to use checksums
0e8ddb47f7d8ac43ab9817e3e329460476ef778c2dfdd6357052b2ae4807b27a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

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 Jun 26, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

1.5.0 This release

6 release files

1.1.1

2 release files

1.1.0

2 release files

0.8.2

2 release files

0.8.1

2 release files

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