Install a Norbix SDK

Install a Norbix SDK and set your credentials once.

Norbix ships one SDK per language. Every SDK works the same way: you install the package, set your credentials once as environment variables, and then create a client with no arguments — the client reads the environment for you.

That is why the code examples across these docs use new Norbix(), NorbixHub(), and the like with empty parentheses. You do not paste your API key into every call.

Prefer the terminal? The Norbix CLI drives the same API — every SDK reference page has a CLI tab.

Pick your language

SDK	Install	Package	Source
JavaScript / TypeScript	npm i @norbix.ai/ts	npm	github
Python	pip install norbix	PyPI	github
.NET	dotnet add package Norbix.Api · Norbix.Hub	NuGet	github
Go	go get github.com/norbix-code/sdk-go	pkg.go.dev	github
Dart / Flutter	dart pub add norbix	pub.dev	github
Swift	Swift Package Manager	github	github
Kotlin	dev.norbix:norbix (Maven)	Maven Central	github
React / Redux	npm i @norbix/react-redux	npm	github

Set your credentials

Set these environment variables once (for example in a .env file or your shell). The client picks them up automatically:

Variable	What it is	Needed for
NORBIX_API_KEY	Your project API key (server-to-server)	All server-side calls
NORBIX_PROJECT_ID	The project the call runs against	All calls
NORBIX_ACCOUNT_ID	Your account	Account-scoped Hub calls only
NORBIX_BEARER_TOKEN	A logged-in user's token	Calls made as an end user
NORBIX_REGION	Your data region (optional)	Non-default regions

With those in place, the client needs nothing:

JavaScript / TypeScript

import { Norbix } from '@norbix.ai/ts';

const norbix = new Norbix(); // reads NORBIX_API_KEY, NORBIX_PROJECT_ID, ...

.NET

using Norbix.Sdk;

using var client = new NorbixClient(); // reads NORBIX_API_KEY, NORBIX_PROJECT_ID, ...

Python

from norbix_python import NorbixHub

norbix = NorbixHub()  # reads NORBIX_API_KEY, NORBIX_PROJECT_ID, ...

Go

c, _ := norbix.New(norbix.Options{}) // reads NORBIX_API_KEY, NORBIX_PROJECT_ID, ...

Dart / Flutter

import 'package:norbix/norbix_hub.dart';

final hub = NorbixHub(); // reads NORBIX_API_KEY, NORBIX_PROJECT_ID, ...

Swift

import NorbixSwift

let client = Norbix() // reads NORBIX_API_KEY, NORBIX_PROJECT_ID, ...

Kotlin

import dev.norbix.sdk.hub.NorbixHub

val hub = NorbixHub() // reads NORBIX_API_KEY, NORBIX_PROJECT_ID, ...

Prefer to pass values in code?

You do not have to use environment variables. Every client also accepts the same values in its constructor — useful for multi-project apps or tests:

JavaScript / TypeScript

const norbix = new Norbix({ apiKey: '<api_key>', projectId: 'pr_09YhICNV067WkJZ3FphoXg' });

.NET

using var client = new NorbixClient(new NorbixClientOptions
{
    ApiKey = "<api_key>",
    ProjectId = "pr_09YhICNV067WkJZ3FphoXg",
});

Python

norbix = NorbixHub(api_key="<api_key>", project_id="pr_09YhICNV067WkJZ3FphoXg", account_id="acc_7R72LiFNr0gzNfCd1tyx52")

Go

c, _ := norbix.New(norbix.Options{ApiKey: "<api_key>", ProjectID: "pr_09YhICNV067WkJZ3FphoXg"})

Dart / Flutter

final hub = NorbixHub(apiKey: '<api_key>', projectId: 'pr_09YhICNV067WkJZ3FphoXg');

Swift

let client = Norbix(apiKey: "<api_key>", projectId: "pr_09YhICNV067WkJZ3FphoXg")

Kotlin

val hub = NorbixHub(apiKey = "<api_key>", projectId = "pr_09YhICNV067WkJZ3FphoXg", accountId = "acc_7R72LiFNr0gzNfCd1tyx52")

Anything you do not set in code falls back to the environment variables above.