Skip to main content

​
Requirements

  • Python 3.11 or higher
uv is a fast Python package manager. It installs Nogic globally and makes it available on your PATH. If you don’t have uv yet: 
curl -LsSf https://astral.sh/uv/install.sh | sh   # macOS/Linux

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"   # Windows
Then install Nogic: 
uv tool install nogic

​
Install with pip

pip install nogic
On newer Python installations (3.12+), you may encounter an “externally-managed-environment” error with pip. Use uv tool install nogic instead, or pass --user to install to your user directory.

​
Install with pipx

pipx install nogic

​
Verify Installation

nogic --version

​
Update

# uv
uv tool upgrade nogic

# pip
pip install --upgrade nogic

# pipx
pipx upgrade nogic

​
Uninstall

# uv
uv tool uninstall nogic

# pip
pip uninstall nogic

# pipx
pipx uninstall nogic

​
Environment Variables

VariableDescription
NOGIC_API_KEYOverride the stored API key for any command
NOGIC_TELEMETRY_DISABLEDSet to 1 to disable anonymous telemetry

​
Configuration Files

Nogic stores configuration in two locations: Global (~/.nogic/config.json) — your API key and telemetry preferences. Created by nogic login. Project-level (.nogic/config.json in your project root) — project ID and name. Created by nogic init.

​
Next Steps

Authentication

Set up your API key and authenticate