Skip to main content

Install the CLI

The chtbio CLI lets you manage your Chat-in-Bio instance from the command line — or let an AI agent do it for you.

Install from PyPI​

pip install chtbio
# or
uv pip install chtbio

Install from source (development)​

cd cli
uv sync

Install server + CLI together​

pip install chatinbio[cli]

Run without installing (PEP 723)​

The CLI ships a standalone script with inline metadata:

uv run cli/chtbio_script.py --help
uv run cli/chtbio_script.py --url http://localhost:8000 --api-key <key> status

Initialize configuration​

chtbio config init

This creates two files in ~/.chtbio/:

FilePurpose
config.tomlServer URL, API key, output format
policy.tomlSafeguard rules (confirmations, permissions)

Configure your connection​

chtbio config set url http://localhost:8000
chtbio config set api_key your-admin-api-key-here

Or use environment variables:

export CHTBIO_URL=http://localhost:8000
export CHTBIO_API_KEY=your-admin-api-key-here

Verify​

chtbio status

Next steps​