> ## Documentation Index
> Fetch the complete documentation index at: https://tsim.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Install tsim with uv or pip, with optional CUDA support.

tsim requires Python 3.10 or later.

## Using uv (recommended)

We recommend using [`uv`](https://docs.astral.sh/uv/) for dependency management.

```bash theme={null}
uv add bloqade-tsim
```

For GPU acceleration with CUDA:

```bash theme={null}
# For CUDA 13
uv add "bloqade-tsim[cuda13]"

# For CUDA 12
uv add "bloqade-tsim[cuda12]"
```

## Using pip

```bash theme={null}
pip install bloqade-tsim
```

For GPU acceleration with CUDA:

```bash theme={null}
pip install "bloqade-tsim[cuda13]"
```

## Development setup

If you're contributing to tsim, clone the repository and install development dependencies:

```bash theme={null}
git clone https://github.com/QuEraComputing/tsim.git
cd tsim
uv sync
```

Install pre-commit hooks to run linting checks automatically:

```bash theme={null}
pre-commit install
```

This will run formatters and linters (black, isort, ruff, pyright) before each commit.