Installation

Install Rosettes using pip, uv, or from source

1 min read 185 words

Requirements

Prerequisites

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

Install

uv add rosettes

pip install rosettes

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

Verify Installation

import rosettes
print(rosettes.__version__)  # 0.1.0

Or from the command line:

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

Python 3.14t (Free-Threading)

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

  1. 1

    Build or install Python 3.14 with `--disable-gil`

    Use the free-threaded build (e.g.python3.14t).

  2. 2

    Install Rosettes normally

    Use pip or uv as shown above.

  3. 3

    Use highlight_many() for true parallelism

    For batch highlighting with true parallelism.

from rosettes import highlight_many

# On 3.14t, this runs with true parallelism
blocks = [("code", "python") for _ in range(100)]
results = highlight_many(blocks)  # 1.5-2x speedup

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

Next Steps