Skip to main content
Root Library Catalog supports pip, uv, and Poetry. All three use the same registry endpoint and credential approach.

Prerequisites

The Root Patcher CLI (rootio_patcher) is required to pull Root-secured packages into your environment. Install it before configuring your package manager.
For macOS Intel and Windows, see the full installation instructions. Then set your API key:

Which tool should I use?

If you’re starting fresh or choosing between tools, here’s a quick guide: All three tools read credentials from ~/.netrc and resolve packages through pkg.root.io/pypi/simple/. The configuration steps differ only in how you point each tool at Root’s registry.

Authentication

All three tools read credentials from ~/.netrc. Add your Root token:

pip

Configure the registry

Install

Add the package to your requirements.txt:
Then install:

uv

Configure the registry

Add to your pyproject.toml:

Install and sync


Poetry

Configure the registry

Install


CI/CD Configuration

Inject credentials via environment and write to ~/.netrc at build time:

Troubleshooting