Installation

Install Kida using pip, uv, or from source

1 min read 211 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.2.2

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

    Install free-threaded Python 3.14

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

  2. 2

    Install Kida normally

    Use pip or uv as shown above.

  3. 3

    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