1
Install
Install the Gnist CLI with pip:
Shell
pip install gnistai
Requires Python 3.10+. The CLI wraps the Gnist Context REST API.
2
Authenticate
Sign up at /signup for a free API key (100 calls/day), then configure it:
Shell
export GNIST_API_KEY="gnist_ctx_abc123..."
Add this to your ~/.bashrc or ~/.zshrc to persist it.
3
Query a Toolkit
The CLI follows the pattern gc <toolkit> <tool> [options]:
Shell
# Search the Norwegian company registry gc brreg search --query "Equinor" # Get current weather in Oslo gc open-meteo current --lat 59.91 --lon 10.75 # Look up a country by code gc geonames country --code NO
Every toolkit and tool available on the platform maps directly to a CLI command.
4
Browse Toolkits
List and filter available toolkits:
Shell
# List all available toolkits gc toolkits list # Filter by category gc toolkits list --category Weather # Get details about a specific toolkit gc toolkits get --slug brreg
5
Output & Scripting
The CLI outputs JSON by default, making it easy to compose with other tools:
Shell
# Pipe to jq for filtering gc brreg search --query "Equinor" | jq '.[] | .name' # Use in shell scripts for slug in $(gc toolkits list --category Finance | jq -r '.[].slug'); do echo "=== $slug ===" gc toolkits get --slug "$slug" | jq '.description' done