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

# Poetry

> Configure Poetry to use Root Library Catalog for secure Python packages.

## Authentication

```bash theme={null}
echo "machine pkg.root.io login token password YOUR_ROOT_TOKEN" >> ~/.netrc
chmod 600 ~/.netrc
```

## Configure the Registry

```bash theme={null}
poetry source add --priority=primary root https://pkg.root.io/pypi/simple/ &&
poetry source add --priority=supplemental pypi
```

## Install

```bash theme={null}
poetry add requests==2.31.0
poetry update
```

## Troubleshooting

| Issue                        | Solution                                       |
| ---------------------------- | ---------------------------------------------- |
| `401 Unauthorized`           | Check `~/.netrc` token and `chmod 600`         |
| Packages resolving from PyPI | Confirm `root` source has `--priority=primary` |