Installation

Install Kida using pip, uv, or from source

1 min read 206 words

Requirements

Prerequisites

1/2 complete
  • Python 3.14+ installed
  • No runtime dependencies (pure Python)

Install

uv add kida-templates

pip install kida-templates

git clone https://github.com/lbliii/kida.git
cd kida
pip install -e .

Or with uv:

git clone https://github.com/lbliii/kida.git
cd kida
uv sync

Verify Installation

import kida
print(kida.__version__)  # 0.9.0

Or from the command line:

python -c "import kida; print(kida.__version__)"

Python 3.14t (Free-Threading)

Kida is optimized for Python 3.14t with free-threading enabled (PEP 703). To use free-threading:

  1. Install free-threaded Python 3.14

Look forpython3.14tor the "free-threaded" installer option.

  1. Install Kida normally

Use pip or uv as shown above.

  1. Render templates concurrently

Use true parallelism withThreadPoolExecutoror similar.

from concurrent.futures import ThreadPoolExecutor
from kida import Environment

env = Environment()
template = env.from_string("Hello, {{ name }}!")

# On 3.14t, this runs with true parallelism (no GIL)
with ThreadPoolExecutor(max_workers=4) as executor:
    results = list(executor.map(
        lambda n: template.render(name=n),
        ["Alice", "Bob", "Charlie", "Diana"]
    ))

See Thread Safety for details on Kida's free-threading support.

Next Steps