​
Installation

Install the SDK with UV (recommended) or pip:
uv pip install nekuda
The SDK ships as a single, pure-Python wheel with minimal dependencies - installation takes ~1 second.

​
Authentication

Grab your secret key from the nekuda Dashboard and set it as an environment variable: 
export NEKUDA_API_KEY="sk_live_..."
# The SDK defaults to the production API: https://api.nekuda.ai
# For staging or local testing, you can override the base URL:
# export NEKUDA_BASE_URL="https://staging-api.nekuda.ai"
Always keep your secret key secure on your backend. Never expose it in client-side code.

​
Your First Call

Create your first script to test authentication:
hello.py
from nekuda import NekudaClient

client = NekudaClient.from_env()
print("🚀 Authenticated! Your account ID is:", client.api_key[:8] + "…")
Run it:
python hello.py
If everything is set up correctly, you should see: 
🚀 Authenticated! Your account ID is: sk_live_12…

​
What’s Next?

Quickstart

Complete your first payment flow in under 5 minutes

Core Concepts

Understand the key building blocks of the SDK