SDK - nemu

The official SDK wraps both flows, manages tokens, and exposes the REST API as typed resources.

Install

npm install @nemu-ai/sdk

bun add @nemu-ai/sdk

Two clients

Nemu

The client credentials client. It fetches and caches a token from your client_id and client_secret. It acts as your own account.

NemuOAuth

The authorization code client. It builds the authorize URL, exchanges the code, and refreshes tokens. It acts as the user who approved access.

Client credentials

import { Nemu } from "@nemu-ai/sdk";

const nemu = new Nemu({
  client_id: process.env.nemu_client_id!,
  client_secret: process.env.nemu_client_secret!,
});

const account = await nemu.user.get();
const workspaces = await nemu.workspaces.list();

Authorization code

import { NemuOAuth } from "@nemu-ai/sdk";

const oauth = new NemuOAuth({
  client_id: process.env.nemu_client_id!,
  client_secret: process.env.nemu_client_secret!,
  redirect_uri: "https://your.app/callback",
});

const { url, code_verifier, state } = await oauth.authorize_url({
  scopes: { profile: "read", workspaces: "read" },
  state: "a_random_value",
});

const nemu = await oauth.exchange_code({ code, code_verifier });
const user = await nemu.user.get();

Restore a session later with from_tokens, and persist rotated tokens with on_refresh.

const nemu = oauth.from_tokens(saved_tokens, (tokens) => save(tokens));

Scopes

authorize_url takes scope strings, bare resource names, or a map, and validates whatever you give it. A typo throws right there instead of surfacing as a 403 later.

import { build_scopes } from "@nemu-ai/sdk";

await oauth.authorize_url({ scopes: { workspaces: true, models: "read" } });
await oauth.authorize_url({ scopes: build_scopes("user", "read", true) });
await oauth.authorize_url({ scopes: ["profile:read", "mapping:write"] });

authorize_url returns the resolved list as scopes alongside the URL. See Scopes for every form, the aliases, and the helpers.

Options

Both clients accept the same options.

string

required

Your application client_id.

string

required

Your application client_secret.

string

Required for NemuOAuth. Must match a registered redirect URI.

string

The dated API version to pin. Defaults to the latest version the SDK knows about.

string

default:"https://app.nemu.cc/api/v1"

The versioned REST base.

number

default:"30000"

Request timeout in milliseconds.

The user resource

const user = await nemu.user.get();
const same = await nemu.user.me();

get and me both return the user described in Get the current user.

Version helpers

import { Nemu, ApiVersion, LATEST_API_VERSION } from "@nemu-ai/sdk";

const nemu = new Nemu({
  client_id: process.env.nemu_client_id!,
  client_secret: process.env.nemu_client_secret!,
  api_version: ApiVersion.V2026_07_14,
});

const info = await nemu.version();
console.log(LATEST_API_VERSION, info.supported);

Working with resources

Resources return live entities you can act on directly.

const workspace = await nemu.workspaces.create({ name: "prod" });
await workspace.update({ name: "production" });

const providers = await workspace.providers.list({ compatibility: "ANTHROPIC" });
const members = await workspace.members.list();
const workflows = await workspace.workflows.list();

const { remaining } = await workspace.get_budget();
await workspace.set_budget(250);

await workspace.delete();

Resource	Where	Verbs
`nemu.user`	account	`get` `me`
`nemu.workspaces`	account	`list` `get` `create`, entity `update` `delete` `gateway_key` `get_budget` `set_budget`
`workspace.members`	workspace	`list` `invite`, entity `update_role` `remove`
`workspace.providers` `models` `prompts` `mappings`	workspace	`list` `get` `create`, entity `update` `delete`
`workspace.workflows`	workspace	`list` `get`
`nemu.indexes`	account	`list` `get` `create` `delete`
`nemu.quotas`	account	`list` `get`, entity `update` `delete`
`nemu.metrics`	account	`list` `get`
`nemu.health`	—	`check`

list on providers, models, prompts, mappings, and workflows accepts the server side filters documented on each API page.

update() sends a full replacement, because the API validates the same schema on PATCH as on POST. Pass every required field, not only the ones you changed. The SDK re-reads the entity afterwards, since the API returns no body on a write.

Creates always land in your account’s default workspace, whichever workspace you scoped them through. Indexes live on the client as nemu.indexes rather than on a workspace, because the API resolves them from the default workspace too.

Errors

The SDK throws typed errors so you can branch on the failure.

import { NemuValidationError, NemuAuthError, NemuRateLimitError } from "@nemu-ai/sdk";

try {
  await nemu.workspaces.list();
} catch (err) {
  if (err instanceof NemuAuthError) reauthenticate();
  else if (err instanceof NemuRateLimitError) wait(err.retry_after);
  else if (err instanceof NemuValidationError) report(err.message);
  else throw err;
}

Error	Raised on
`NemuValidationError`	`400`, including an unsupported API version
`NemuAuthError`	`401`
`NemuPermissionError`	`403`
`NemuNotFoundError`	`404`
`NemuRateLimitError`	`429`, carries `retry_after`
`NemuServerError`	`500` and above
`NemuNetworkError`	The request never completed

​Install

​Two clients

Nemu

NemuOAuth

​Client credentials

​Authorization code

​Scopes

​Options

​The user resource

​Version helpers

​Working with resources

​Errors

Install

Two clients

Client credentials

Authorization code

Scopes

Options

The user resource

Version helpers

Working with resources

Errors