shadowebtechnologies/python repository overview

⁠Free-threaded Python 3.14 Docker Images

Unofficial Python 3.14 free-threaded Docker images based on Debian Trixie, Debian Trixie Slim, and Alpine.

These images provide a python:3.14-*-style experience, but use the experimental/free-threaded Python build, commonly referred to as Python 3.14t.

⁠Available Tags

⁠Usage

FROM shadowebtechnologies/python:3.14t-slim

WORKDIR /app

COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

COPY . .

CMD ["python", "-m", "your_app"]

⁠Free-threaded Python

These images are built with a free-threaded Python runtime. Inside the container, the interpreter is available as:

python
python3
python3.14t

You can verify the free-threaded build with:

python - <<'PY'
import sys
import sysconfig

print(sys.version)
print("abiflags:", sys.abiflags)
print("Py_GIL_DISABLED:", sysconfig.get_config_var("Py_GIL_DISABLED"))
print("GIL enabled:", sys._is_gil_enabled())
PY

Expected output includes:

abiflags: t
Py_GIL_DISABLED: 1
GIL enabled: False

⁠Notes

Python free-threading is still experimental. Some third-party packages, especially packages with native extensions, may not yet fully support free-threaded Python.

For the best compatibility, use:

FROM shadowebtechnologies/python:3.14t-slim

Use the Alpine image only after testing your dependency stack against Alpine/musl and free-threaded Python.

⁠Tags

shadowebtechnologies/python:3.14t-trixie
shadowebtechnologies/python:3.14t-slim
shadowebtechnologies/python:3.14t-alpine

⁠Disclaimer

These are unofficial images and are not affiliated with the official Python Docker images or the Python Software Foundation.