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

# Using Poetry

[https://python-poetry.org/](https://python-poetry.org/)

Poetry is a tool for **dependency management** and **packaging** in Python. It allows you to declare the libraries your project depends on and it will manage (install/update) them for you.

### Initialize a new project

This command starts an interactive process to create a new `pyproject.toml` file. It guides you through defining your project's metadata, including name, version, description, author, license, and dependencies.

```bash theme={"system"}
poetry init
```

### Install project dependencies

This command reads the `pyproject.toml` file in your project, resolves the dependencies, and installs them into a new virtual environment. 

If a `poetry.lock` file exists, it uses this to ensure reproducible installations across different environments.

```bash theme={"system"}
poetry install
```

### Enter the virtual environment

This command spawns a new shell with the virtual environment activated. It allows you to run your project and its dependencies in an isolated environment, ensuring that you're using the correct versions of all packages.

```bash theme={"system"}
poetry shell
```

### Deactivate the virtual environment

To exit the Poetry shell and deactivate the virtual environment, you can use:

```bash theme={"system"}
exit
```


## Related topics

- [Python Scripts](/products/bolt/creating-schedules/command-settings/python-scripts.md)
- [Virtual Environments](/developers/virtual-environments/index.md)
- [dlt Data Pipeline - Google Sheets to Snowflake](/guides/using-dlt-in-paradime/python-data-pipeline-using-dlthub-google-sheets-to-snowflake.md)
- [Linear Backlog Agent](/guides/programmable-agents/linear-backlog-agent.md)
- [dbt™ Documentation Backfiller](/guides/programmable-agents/doc-backfiller.md)