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

# Install bunker-fold with Poetry

> Install the bunker-fold Python SDK with Poetry. Covers adding the dependency, locking, virtualenvs, version pinning, and upgrading in a Poetry project.

Use Poetry when you want lockfile-driven dependency management with a single `pyproject.toml` as the source of truth.

## Add to a project

```bash theme={null}
poetry add bunker-fold
```

This updates `pyproject.toml` and writes `poetry.lock`.

## Bootstrap a new project

```bash theme={null}
poetry new my-bunker-app
cd my-bunker-app
poetry add bunker-fold
poetry run python -c "import bunker_fold; print(bunker_fold.__version__)"
```

## Pin a version

```bash theme={null}
poetry add "bunker-fold==1.4.2"
```

Or edit `pyproject.toml` directly:

```toml theme={null}
[tool.poetry.dependencies]
python = "^3.9"
bunker-fold = "1.4.2"
```

Then run:

```bash theme={null}
poetry lock
poetry install
```

## Upgrade

```bash theme={null}
poetry update bunker-fold
```

## Verify

```bash theme={null}
poetry run python -c "import bunker_fold; print(bunker_fold.__version__)"
```