Skip to main content

YDF - Yggdrasil Decision Forests for Python

YDF is a library for training, serving, and interpreting decision forest models. It acts as a lightweight, efficient wrapper around the C++ Yggdrasil Decision Forests library.

It provides fast access to core methods along with advanced features for model import/export, evaluation, and inspection.

YDF is the official successor to TensorFlow Decision Forests (TF-DF) and is recommended for new projects due to its superior performance and features.

Installation

Install YDF from PyPI:

pip install ydf

For detailed build instructions, see INSTALLATION.md.

Usage Example

import ydf
import pandas as pd

# Load dataset
ds_path = "https://raw.githubusercontent.com/google/yggdrasil-decision-forests/main/yggdrasil_decision_forests/test_data/dataset"
train_ds = pd.read_csv(f"{ds_path}/adult_train.csv")
test_ds = pd.read_csv(f"{ds_path}/adult_test.csv")

# Train a Gradient Boosted Trees model
model = ydf.GradientBoostedTreesLearner(label="income").train(train_ds)

# Evaluate the model
print(model.evaluate(test_ds))

# Save the model
model.save("my_model")

# Load the model
loaded_model = ydf.load_model("my_model")

Documentation

For more information, visit the YDF Documentation.

Frequently asked questions are available in the FAQ.

Metadata

Release files for ydf 0.17.0

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

Built distributions (wheels)

Table of built distributions (wheels) for ydf 0.17.0
File Actions
ydf-0.17.0-cp314-cp314-manylinux_2_27_x86_64.whl CPython 3.14 CPython 3.14 Linux glibc 2.27+ x86-64 Details for ydf-0.17.0-cp314-cp314-manylinux_2_27_x86_64.whl
ydf-0.17.0-cp314-cp314-macosx_12_0_arm64.whl CPython 3.14 CPython 3.14 macOS 12.0+ ARM64 Details for ydf-0.17.0-cp314-cp314-macosx_12_0_arm64.whl
ydf-0.17.0-cp313-cp313-manylinux_2_27_x86_64.whl CPython 3.13 CPython 3.13 Linux glibc 2.27+ x86-64 Details for ydf-0.17.0-cp313-cp313-manylinux_2_27_x86_64.whl
ydf-0.17.0-cp313-cp313-macosx_12_0_arm64.whl CPython 3.13 CPython 3.13 macOS 12.0+ ARM64 Details for ydf-0.17.0-cp313-cp313-macosx_12_0_arm64.whl
ydf-0.17.0-cp312-cp312-manylinux_2_27_x86_64.whl CPython 3.12 CPython 3.12 Linux glibc 2.27+ x86-64 Details for ydf-0.17.0-cp312-cp312-manylinux_2_27_x86_64.whl
ydf-0.17.0-cp312-cp312-macosx_12_0_arm64.whl CPython 3.12 CPython 3.12 macOS 12.0+ ARM64 Details for ydf-0.17.0-cp312-cp312-macosx_12_0_arm64.whl
ydf-0.17.0-cp311-cp311-manylinux_2_27_x86_64.whl CPython 3.11 CPython 3.11 Linux glibc 2.27+ x86-64 Details for ydf-0.17.0-cp311-cp311-manylinux_2_27_x86_64.whl
ydf-0.17.0-cp311-cp311-macosx_12_0_arm64.whl CPython 3.11 CPython 3.11 macOS 12.0+ ARM64 Details for ydf-0.17.0-cp311-cp311-macosx_12_0_arm64.whl
ydf-0.17.0-cp310-cp310-manylinux_2_27_x86_64.whl CPython 3.10 CPython 3.10 Linux glibc 2.27+ x86-64 Details for ydf-0.17.0-cp310-cp310-manylinux_2_27_x86_64.whl
ydf-0.17.0-cp310-cp310-macosx_12_0_arm64.whl CPython 3.10 CPython 3.10 macOS 12.0+ ARM64 Details for ydf-0.17.0-cp310-cp310-macosx_12_0_arm64.whl

Total release size: 97.2 MB

Release files / ydf-0.17.0-cp314-cp314-manylinux_2_27_x86_64.whl

Download URL ydf-0.17.0-cp314-cp314-manylinux_2_27_x86_64.whl
Size 10.4 MB
Tags CPython 3.14 Linux glibc 2.27+ x86-64
SHA-256 checksum
How to use checksums
974a2cceff907102299f3ce1aeb252aed8aeaf775f80bd38782f02260d831af3
BLAKE2b-256 checksum
How to use checksums
5d7d4ee280a1ef3090cc3ff28129f1a0bec1f6d698094f11922f54b4e6b51194
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.2.0 CPython/3.11.2

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 Google Cloud, verified by PyPI on Nov 2, 2026.

Transparency log

Release files / ydf-0.17.0-cp314-cp314-macosx_12_0_arm64.whl

Download URL ydf-0.17.0-cp314-cp314-macosx_12_0_arm64.whl
Size 9.1 MB
Tags CPython 3.14 macOS 12.0+ ARM64
SHA-256 checksum
How to use checksums
bd7ef53c413c156412a41f277a8b9725f236661289c8051b18138bccb12153d9
BLAKE2b-256 checksum
How to use checksums
747b1aa2132f53db5da647e23184db596538c4f65b7ba1409053cfddde1ff32e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.2.0 CPython/3.11.2

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 Google Cloud, verified by PyPI on Nov 2, 2026.

Transparency log

Release files / ydf-0.17.0-cp313-cp313-manylinux_2_27_x86_64.whl

Download URL ydf-0.17.0-cp313-cp313-manylinux_2_27_x86_64.whl
Size 10.4 MB
Tags CPython 3.13 Linux glibc 2.27+ x86-64
SHA-256 checksum
How to use checksums
baed3d6db550898694679a06bb96dc085f45d7e59847875388954459a8436b05
BLAKE2b-256 checksum
How to use checksums
c38eece274e9003833aa06c39b9818361b5e7d24df1c1967ba95c70e1e980a92
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.2.0 CPython/3.11.2

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 Google Cloud, verified by PyPI on Nov 2, 2026.

Transparency log

Release files / ydf-0.17.0-cp313-cp313-macosx_12_0_arm64.whl

Download URL ydf-0.17.0-cp313-cp313-macosx_12_0_arm64.whl
Size 9.1 MB
Tags CPython 3.13 macOS 12.0+ ARM64
SHA-256 checksum
How to use checksums
fcaa2fda96d0e71cb3f239e40c4fc167ff40981373437aa33835c2d03c27fbf5
BLAKE2b-256 checksum
How to use checksums
e49f6524c71d3f0a238a45db7870a8a187338f9b28213f09458e9c311ce991e2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.2.0 CPython/3.11.2

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 Google Cloud, verified by PyPI on Nov 2, 2026.

Transparency log

Release files / ydf-0.17.0-cp312-cp312-manylinux_2_27_x86_64.whl

Download URL ydf-0.17.0-cp312-cp312-manylinux_2_27_x86_64.whl
Size 10.4 MB
Tags CPython 3.12 Linux glibc 2.27+ x86-64
SHA-256 checksum
How to use checksums
5ee2d181cefe048d0a37917c869e4eb3959ee17242511c043f77fb07ee208dfd
BLAKE2b-256 checksum
How to use checksums
7ed01cf5afdba581c551e48918144ad26f225d922b1e0b553dc93d90f1a3c61a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.2.0 CPython/3.11.2

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 Google Cloud, verified by PyPI on Nov 2, 2026.

Transparency log

Release files / ydf-0.17.0-cp312-cp312-macosx_12_0_arm64.whl

Download URL ydf-0.17.0-cp312-cp312-macosx_12_0_arm64.whl
Size 9.1 MB
Tags CPython 3.12 macOS 12.0+ ARM64
SHA-256 checksum
How to use checksums
651ad311783e7bd68316b59082001530035dd80b8cca21a92b35df216fe90bc2
BLAKE2b-256 checksum
How to use checksums
38bc53655ad87ed65704ed0535550ba844c40209d13e6c55b78c4960c0634f9b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.2.0 CPython/3.11.2

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 Google Cloud, verified by PyPI on Nov 2, 2026.

Transparency log

Release files / ydf-0.17.0-cp311-cp311-manylinux_2_27_x86_64.whl

Download URL ydf-0.17.0-cp311-cp311-manylinux_2_27_x86_64.whl
Size 10.4 MB
Tags CPython 3.11 Linux glibc 2.27+ x86-64
SHA-256 checksum
How to use checksums
e8e39e516d5be7538d2687fd927c434a68d167ca21e0762d2de9c462836f8874
BLAKE2b-256 checksum
How to use checksums
a46a59655cc2b6bc2e4d4c9a7f7615ef673096d6243bda4911ab21bb2df12500
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.2.0 CPython/3.11.2

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 Google Cloud, verified by PyPI on Nov 2, 2026.

Transparency log

Release files / ydf-0.17.0-cp311-cp311-macosx_12_0_arm64.whl

Download URL ydf-0.17.0-cp311-cp311-macosx_12_0_arm64.whl
Size 9.1 MB
Tags CPython 3.11 macOS 12.0+ ARM64
SHA-256 checksum
How to use checksums
fc2f9a92f10527ca11848ebbf7c51a58aa354ec3312829d4be53e3fbe51f004a
BLAKE2b-256 checksum
How to use checksums
4a96386fe43f06eea2ad5ebb84e883a480694429a24df24e0c9d93d352863edb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.2.0 CPython/3.11.2

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 Google Cloud, verified by PyPI on Nov 2, 2026.

Transparency log

Release files / ydf-0.17.0-cp310-cp310-manylinux_2_27_x86_64.whl

Download URL ydf-0.17.0-cp310-cp310-manylinux_2_27_x86_64.whl
Size 10.4 MB
Tags CPython 3.10 Linux glibc 2.27+ x86-64
SHA-256 checksum
How to use checksums
e9d644b6114f66dff45adb9f226406a89fcb08f29824bbc9180f8817594282f3
BLAKE2b-256 checksum
How to use checksums
0df949a499bff10c00dee07cc8c1e56ae48ff1ab69c9fc0080a52e85f084b61b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.2.0 CPython/3.11.2

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 Google Cloud, verified by PyPI on Nov 2, 2026.

Transparency log

Release files / ydf-0.17.0-cp310-cp310-macosx_12_0_arm64.whl

Download URL ydf-0.17.0-cp310-cp310-macosx_12_0_arm64.whl
Size 9.1 MB
Tags CPython 3.10 macOS 12.0+ ARM64
SHA-256 checksum
How to use checksums
174d5d329d03c392f08653e04ac54d33a7e41130f9dc3e3954912cfda9fc7697
BLAKE2b-256 checksum
How to use checksums
462290e2449c04e98ec48fd4fbcd5ec40c6adfa8107dda26172cd899b5227a5f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.2.0 CPython/3.11.2

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 Google Cloud, verified by PyPI on Nov 2, 2026.

Transparency log

Security for ydf 0.17.0

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.

Full provenance

All 10 files in this release have been uploaded with provenance metadata.

Select from 10 files

Attestation for ydf-0.17.0-cp314-cp314-manylinux_2_27_x86_64.whl

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by Google Cloud, verified by PyPI on Nov 2, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.17.0 This release

10 release files Full provenance

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