Skip to main content

onnxruntime-ggml

An onnxruntime execution provider that runs ONNX models on ggml's Metal, Vulkan and CPU kernels.

uv pip install onnxruntime-ggml

Requires Python 3.11 or newer.

The wheel includes the native provider and installs a compatible onnxruntime. Supports macOS 14+ (Apple silicon), Linux x86_64 (glibc 2.35+) and aarch64 (glibc 2.39+), and Windows x64. No compiler or separate ggml installation is needed.

import onnxruntime_ggml as ggml

session = ggml.InferenceSession("model.onnx")            # ggml first, CPU provider as fallback
session = ggml.InferenceSession("model.onnx", {"device": "cpu", "threads": 4})

Or keep your own session options:

import onnxruntime as ort, onnxruntime_ggml as ggml

so = ggml.session_options({"device": "gpu"})
session = ort.InferenceSession("model.onnx", so)

Set ORT_GGML_LOG=debug to see what the provider does with a graph. Full docs: https://github.com/thewh1teagle/onnxruntime-ggml

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.

onnxruntime_ggml-0.2.0-py3-none-win_amd64.whl (17.9 MB view details)

Uploaded Python 3Windows x86-64

onnxruntime_ggml-0.2.0-py3-none-manylinux_2_38_aarch64.manylinux_2_39_aarch64.whl (18.5 MB view details)

Uploaded Python 3manylinux: glibc 2.38+ ARM64manylinux: glibc 2.39+ ARM64

onnxruntime_ggml-0.2.0-py3-none-manylinux_2_35_x86_64.whl (22.5 MB view details)

Uploaded Python 3manylinux: glibc 2.35+ x86-64

onnxruntime_ggml-0.2.0-py3-none-macosx_14_0_arm64.whl (1.8 MB view details)

Uploaded Python 3macOS 14.0+ ARM64

File details

Details for the file onnxruntime_ggml-0.2.0-py3-none-win_amd64.whl.

File metadata

  • Download URL: onnxruntime_ggml-0.2.0-py3-none-win_amd64.whl
  • Upload date:
  • Size: 17.9 MB
  • Tags: Python 3, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.6 {"installer":{"name":"uv","version":"0.11.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for onnxruntime_ggml-0.2.0-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 8c4d749f910cdb07b740b818bf906917ef7a1b3d1a58cb3cb88cd62e01bc10ca
MD5 7f5d9ac679f8a100465889fa25855fad
BLAKE2b-256 2454efd45c40b55c72dce3e267e53446371551212960255468cfbf34b10ada50

See more details on using hashes here.

File details

Details for the file onnxruntime_ggml-0.2.0-py3-none-manylinux_2_38_aarch64.manylinux_2_39_aarch64.whl.

File metadata

  • Download URL: onnxruntime_ggml-0.2.0-py3-none-manylinux_2_38_aarch64.manylinux_2_39_aarch64.whl
  • Upload date:
  • Size: 18.5 MB
  • Tags: Python 3, manylinux: glibc 2.38+ ARM64, manylinux: glibc 2.39+ ARM64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.6 {"installer":{"name":"uv","version":"0.11.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for onnxruntime_ggml-0.2.0-py3-none-manylinux_2_38_aarch64.manylinux_2_39_aarch64.whl
Algorithm Hash digest
SHA256 8e7ea1fb79109a136f9783559df3ee9d3562e091dbf199fc3e8d04544d5a8316
MD5 ffea820e406c767464604ca35ddb5e23
BLAKE2b-256 dc51b32c51aa0165486f64ac2b389b785bb0861ad4c594bd12779b946272a5ca

See more details on using hashes here.

File details

Details for the file onnxruntime_ggml-0.2.0-py3-none-manylinux_2_35_x86_64.whl.

File metadata

  • Download URL: onnxruntime_ggml-0.2.0-py3-none-manylinux_2_35_x86_64.whl
  • Upload date:
  • Size: 22.5 MB
  • Tags: Python 3, manylinux: glibc 2.35+ x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.6 {"installer":{"name":"uv","version":"0.11.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for onnxruntime_ggml-0.2.0-py3-none-manylinux_2_35_x86_64.whl
Algorithm Hash digest
SHA256 2342809f3f6dc2d7b6d303f3bcde391ec5ab10177ce45aec9365880aa5914745
MD5 d589f2205e13d6427b0e4283bd4cdc31
BLAKE2b-256 035c081250a15a155684d1255840d01ca31a9fa556a0e1bfd461a841b940559a

See more details on using hashes here.

File details

Details for the file onnxruntime_ggml-0.2.0-py3-none-macosx_14_0_arm64.whl.

File metadata

  • Download URL: onnxruntime_ggml-0.2.0-py3-none-macosx_14_0_arm64.whl
  • Upload date:
  • Size: 1.8 MB
  • Tags: Python 3, macOS 14.0+ ARM64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.6 {"installer":{"name":"uv","version":"0.11.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for onnxruntime_ggml-0.2.0-py3-none-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 b044e7813ab0af094c07ec1bf371cff858138362037c7512c814dfe89f939228
MD5 3de7524155c34775efe79e6f7418d6fd
BLAKE2b-256 a19216e4c27d31a9c12e701d819fb7971bbabe6c18ed2a399cf1139866a9448a

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.2.0 This release

4 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