Skip to main content
Applicable to: Customers who install the truefoundry package 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.

​
What Is Changing

Starting with truefoundry v0.17.0, 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 versionMinimum Python
truefoundry before v0.17.03.8
After:
Package versionMinimum Python
truefoundry v0.17.0 and later3.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 stopped receiving security updates in October 2024; Python 3.9 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

1

Check your Python version

On every machine, container image, and CI job that installs or runs the CLI:
python --version
# or
python3 --version
2

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.
3

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.
4

Upgrade the package

After Python is upgraded, install the latest CLI:
pip install --upgrade "truefoundry>=0.17.0"
If you have questions or need help upgrading, reach out to support@truefoundry.com — we’re happy to assist.