Installation

Install Kida using pip, uv, or from source

1 min read 156 words

Requirements

  • Python 3.14+ (required)
  • No runtime dependencies (pure Python)

Using pip

pip install kida

Using uv

uv add kida

From Source

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

Verify Installation

import kida
print(kida.__version__)  # 0.1.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. Build or install Python 3.14 with--disable-gil
  2. Install Kida normally
  3. Render templates concurrently with true parallelism
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.