> ## Documentation Index
> Fetch the complete documentation index at: https://www.truefoundry.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Minimum Python Version Raised to 3.10 — truefoundry v0.17.0

> The truefoundry PyPI package requires Python 3.10 or later from v0.17.0. Python 3.8 and 3.9 are no longer supported.

<Note>
  **Applicable to:** Customers who install the **[`truefoundry` package](https://pypi.org/project/truefoundry/)** on **Python 3.8 or 3.9**. This includes:

  * **AI Engineering module** — the CLI and SDK for deploying services, jobs, notebooks, and workflows on your compute plane, and for experiment tracking.
  * **AI Gateway GitOps and SDK** — running `tfy apply` in CI to manage models, guardrails, MCP servers, or skills, or using the `truefoundry` Python SDK to create agents in the Agent Registry.

  If you use **only the AI Gateway module** through the UI, HTTP APIs, or MCP-compatible clients (Cursor, Claude Desktop) and never install the `truefoundry` package locally or in CI, this change does not affect you.
</Note>

## What Is Changing

Starting with **[`truefoundry` v0.17.0](https://pypi.org/project/truefoundry/)**, the minimum supported Python version is **3.10**. Installing or running v0.17.0 and later on Python 3.8 or 3.9 is no longer supported.

**Before:**

| Package version                  | Minimum Python |
| -------------------------------- | -------------- |
| `truefoundry` **before v0.17.0** | **3.8**        |

**After:**

| Package version                     | Minimum Python |
| ----------------------------------- | -------------- |
| `truefoundry` **v0.17.0 and later** | **3.10**       |

New installs and upgrades to v0.17.0+ require Python 3.10 or later.

## Why This Change

* **Python 3.8 and 3.9 have reached end-of-life** — [Python 3.8](https://endoflife.date/python) stopped receiving security updates in October 2024; [Python 3.9](https://endoflife.date/python) in October 2025.
* **Upstream dependencies no longer support EOL runtimes** — packages used by the TrueFoundry CLI have dropped support for Python versions below 3.10, so we cannot continue to ship compatible, security-maintained releases on those versions.

## What You Need to Do

<Steps>
  <Step title="Check your Python version">
    On every machine, container image, and CI job that installs or runs the CLI:

    ```bash theme={"dark"}
    python --version
    # or
    python3 --version
    ```
  </Step>

  <Step title="Upgrade to Python 3.10 or later">
    Move to Python 3.10+ before upgrading the package to v0.17.0. Python 3.11 or 3.12 is recommended for longer active and security support — see the [Python release schedule](https://endoflife.date/python).
  </Step>

  <Step title="Update CI/CD and container images">
    Switch base images and runners to Python 3.10+ — for example, `python:3.11-slim` instead of `python:3.9-slim`.
  </Step>

  <Step title="Upgrade the package">
    After Python is upgraded, install the latest CLI:

    ```bash theme={"dark"}
    pip install --upgrade "truefoundry>=0.17.0"
    ```
  </Step>
</Steps>

***

If you have questions or need help upgrading, reach out to [**support@truefoundry.com**](mailto:support@truefoundry.com) — we're happy to assist.