crbonfree 0.1.0

Python SDK for the CrbonFree carbon-offset API

crbonfree

Measure and offset the carbon footprint of your AI workloads.
One SDK. Every major provider. Verified retirement receipts.

pip install crbonfree

What is CrbonFree?

CrbonFree meters the carbon emissions of your AI inference and turns them into verifiable offsets. Connect your provider accounts, and we measure the inference, give you the emissions data, and issue signed carbon retirement receipts you can hand to auditors.

Works with OpenAI, Anthropic, OpenRouter, AWS Bedrock, and growing.

Quickstart

Authenticate with an API key

Pass your key directly to the client:

from crbonfree import CrbonFree

crbon = CrbonFree(api_key="ck_live_...")

summary = crbon.telemetry.get_summary()
print(f"{summary.data.total_co2_kg} kg CO2 from your AI usage")

Or read it from the environment

Keep the key out of your source by reading it from CRBONFREE_API_KEY:

export CRBONFREE_API_KEY="ck_live_..."

import os
from crbonfree import CrbonFree

crbon = CrbonFree(api_key=os.environ["CRBONFREE_API_KEY"])

summary = crbon.telemetry.get_summary()
print(f"{summary.data.total_co2_kg} kg CO2 from your AI usage")

The API key is sent on every request as the X-API-Key header.

Async

An async client ships alongside the sync one:

import asyncio
from crbonfree import AsyncCrbonFree

async def main():
    crbon = AsyncCrbonFree(api_key="ck_live_...")
    summary = await crbon.telemetry.get_summary()
    print(f"{summary.data.total_co2_kg} kg CO2 from your AI usage")

asyncio.run(main())

What you can do

	Method	What it returns
Measure	crbon.telemetry.get_summary()	Total CO2, per-model rollups, daily chart
Analyze	crbon.usage.get_breakdown()	Which models cost the most carbon
Organize	crbon.projects.list()	Track emissions by project / team
Prove	crbon.billing.list_receipts()	Signed carbon retirement receipts
Audit	crbon.billing.list_audit_packs()	CSRD-ready compliance artifacts
Manage	crbon.apikeys.create()	Programmatic API key management

Pagination

Listing endpoints accept page and limit parameters directly:

receipts = crbon.billing.list_receipts(page=1, limit=20)
for receipt in receipts.data:
    print(receipt.serial_number)

What's next

Ergonomic auto-pagination helpers and a crbonfree login CLI for zero-config, browser-based authentication are coming in a fast-follow release.

---

Dashboard  ·  Issues  ·  Website

_{MIT — Crbon Labs Inc.}