Installation

Install the CLIMeter Python SDK and configure it for your project.

Install via pip

Bash

pip install climeter

Python SDK

Install via pip install climeter. Python 3.8+ required. Node.js SDK: npm install @auvh/climeter.

Supported Python versions: 3.8, 3.9, 3.10, 3.11, 3.12. The SDK has zero required runtime dependencies beyond the standard library.

Environment variables

Configure the SDK via environment variables — no code changes needed between environments.

.env

Bash

# Required
CLIMETER_API_KEY=clmtr_your_key_here

# Optional
CLIMETER_TOOL_SLUG=my-tool           # default tool slug
CLIMETER_API_URL=https://api.climeter.ai  # override API base URL

Use a .env loader

In development, use python-dotenv or direnv to load your .env file automatically. In production, set environment variables via your deployment platform (DigitalOcean, Fly.io, Railway, Docker, etc.).

pyproject.toml integration

Add CLIMeter as a dependency in your pyproject.toml:

pyproject.toml

TOML

[project]
name = "my-cli-tool"
version = "0.1.0"
requires-python = ">=3.8"
dependencies = [
    "climeter>=0.1.0",
]

[tool.climeter]
tool_id = "my-cli-tool"
env = "production"

Install project deps including CLIMeter:

Bash

pip install -e .

Verify installation

Python

python -c "import climeter; print(climeter.__version__)"
# 0.1.0

# Or test the connection
python -c "
from climeter import meter
meter.configure(api_key='clmtr_test')
print('SDK imported successfully')
"