Prerequisites
The Root Patcher CLI (rootio_patcher) is required to pull Root-secured packages into your environment. Install it before configuring your package manager.
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 yourrequirements.txt:
uv
Configure the registry
Add to yourpyproject.toml:
Install and sync
Poetry
Configure the registry
Install
CI/CD Configuration
Inject credentials via environment and write to~/.netrc at build time: