Getting Started

Install the nekuda SDK, set your API key and make your first authenticated call.

Installation

Python

Install the SDK with UV (recommended) or pip:

UV (Recommended)

uv pip install nekuda

The SDK ships as a single, pure-Python wheel with minimal dependencies - installation takes ~1 second.

Install the SDK with UV (recommended) or pip:

UV (Recommended)

uv pip install nekuda

The SDK ships as a single, pure-Python wheel with minimal dependencies - installation takes ~1 second.

Install the SDK with your preferred package manager:

npm

npm install @nekuda/nekuda-js

The SDK ships as a modern TypeScript package with minimal dependencies and full tree-shaking support.

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:

Python

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

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

hello.ts

import { NekudaClient } from '@nekuda/nekuda-js';

async function main() {
  // Initialize client
  const client = NekudaClient.fromEnv();
  
  // Test the connection
  try {
    const user = client.user('test_user');
    console.log('✅ Connected to Nekuda API!');
    console.log(`   Base URL: ${(client as any).baseUrl}`);
    console.log(`   API Key: ${(client as any).apiKey.slice(0, 8)}...`);
  } catch (error) {
    console.log(`❌ Connection failed: ${error}`);
  }
}

main().catch(console.error);

Run it:

npx ts-node hello.ts

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

Assistant

Responses are generated using AI and may contain mistakes.