First billing in 5 minutes

A complete walkthrough from zero to receiving your first payout. Follow each step in order — this is the fastest path to a metered, billing-ready tool.

1

Create a CLIMeter account

Sign up at climeter.ai/register. Verify your email. You will land on the dashboard.

2

Install the SDK

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

Register your tool

In the dashboard, go to Tools → New Tool. Fill in:

  • Slug: my-first-tool
  • Name: anything descriptive
  • Pricing: per_call at $0.01

Or via API:

Bash
curl -X POST https://api.climeter.ai/v1/tools \
  -H "Authorization: Bearer <jwt>" \
  -d '{"slug":"my-first-tool","name":"My First Tool","pricing":{"type":"per_call","price_usd":0.01}}'
4

Add metering to your code

tool.py
Python
import os
from climeter import meter

meter.configure(
    api_key=os.environ["CLIMETER_API_KEY"],
    tool_slug="my-first-tool",
)

@meter.track()
def my_tool(input: str) -> str:
    # Your existing logic — unchanged
    return f"Processed: {input}"

if __name__ == "__main__":
    result = my_tool("hello world")
    print(result)
    meter.flush()  # ensure event is sent before exit
5

Connect Stripe

Go to Billing → Stripe Connect in the dashboard. Click Connect with Stripe and complete the onboarding.

Tip
You need a Stripe account. If you do not have one, Stripe will let you create one during the onboarding flow. See the Payments guide for full details.
6

Make a test call

Bash
python tool.py
# Processed: hello world

Check the CLIMeter dashboard under Events — you should see your first event within seconds. Under Billing, you will see the pending revenue for the current period.

Done

Your tool is live and billing. Share it with users or list it on the CLIMeter Marketplace.

PreviousAuthenticationNextPayments & payouts
First billing in 5 minutes — CLIMeter Docs