Setting up

Libraries, APIs and community

On this page

Packages
Published clients
Install
Helpers and error types
Other ways to connect
MCP tools
Community

Choose a client for your language, use the CLI or MCP server, or generate your own client from the OpenAPI spec. The Quick Start shows complete image and video programs using the published packages.

Packages #

Client	Package	Version
TypeScript	`@nolgia/sdk`	0.1.4
Python	`nolgia` on PyPI	0.1.4
Rust	`nolgia-client`	published with the CLI release; see crates.io

Published clients #

Language	Published package	Interface
TypeScript	`@nolgia/sdk` on npm	`createNolgiaClient` returns an `openapi-fetch` client typed from the spec; call `GET` and `POST`.
Python	`nolgia` on PyPI	Import endpoint modules from `nolgia.api.*` and request and response types from `nolgia.models`.
Rust	`nolgia-client` on crates.io, released with the CLI	A progenitor-generated builder client: `client.generate_image().body_map(…).send()`.

Install #

shell

$ npm install @nolgia/sdk

shell

$ yarn add @nolgia/sdk

shell

$ pnpm add @nolgia/sdk

shell

$ bun add @nolgia/sdk

shell

$ pip install nolgia

shell

$ uv add nolgia

shell

$ cargo add nolgia-client

shell

$ brew install nolgiainc/nolgia/nolgia

shell

$ curl -fsSL https://raw.githubusercontent.com/nolgiainc/nolgia-cli/main/install.sh | bash

shell

$ curl https://api.nolgia.ai/v1/me -H "Authorization: Bearer $NOLGIA_TOKEN"

Helpers and error types #

Other ways to connect #

Surface	Start here
Terminal and scripts	The CLI
Claude Code, Cursor and Codex	Run MCP
Coding-agent skills and installation runbook	Nolgia for Claude Code, Cursor and Codex
REST endpoints and schemas	API reference and OpenAPI spec
Plain-text and JSON discovery	Agent-readable surfaces

MCP tools #

The server registry has 72 tools in eight groups.

Generate

Tool	What it does
`nolgia_text_to_image`	Generate image from text
`nolgia_image_to_image`	Generate image from an image
`nolgia_text_to_video`	Generate video from text
`nolgia_image_to_video`	Animate an image into video
`nolgia_text_to_audio`	Generate audio from text
`nolgia_run_preset`	Run a preset
`nolgia_render_blocks`	Assemble clips and narration into one video
`nolgia_multicam_plan`	Plan a Multicam job
`nolgia_multicam_start`	Start a Multicam job
`nolgia_multicam_run`	Check a Multicam job
`nolgia_multicam_download`	Download every Multicam angle
`nolgia_multicam_cancel`	Stop a Multicam job
`nolgia_generate_3d`	Generate a 3D model
`nolgia_generate_set`	Generate a set of images
`nolgia_miroge_options`	Price a Miroge remake
`nolgia_miroge`	Remake a clip with Miroge

Your library

Tool	What it does
`nolgia_list_assets`	List generated assets
`nolgia_get_asset`	Open an asset
`nolgia_delete_asset`	Trash an asset
`nolgia_update_asset_tags`	Set an asset's tags
`nolgia_upload_asset`	Upload an image
`nolgia_list_characters`	List saved characters
`nolgia_get_character`	Get one character
`nolgia_create_character`	Save a character
`nolgia_update_character`	Update a character
`nolgia_delete_character`	Delete a character
`nolgia_list_styles`	List saved styles
`nolgia_create_style`	Save a style
`nolgia_delete_style`	Delete a saved style
`nolgia_transcribe_asset`	Transcribe an asset
`nolgia_get_transcript`	Get an asset transcript
`nolgia_suggest_clips`	Find short video clips
`nolgia_create_clips`	Create short video clips
`nolgia_get_set`	Get a set of images
`nolgia_get_miroge`	Check a Miroge remake

Projects

Tool	What it does
`nolgia_list_projects`	List projects
`nolgia_get_project`	Get one project
`nolgia_create_project`	Create a project
`nolgia_update_project`	Update a project
`nolgia_delete_project`	Delete a project
`nolgia_add_project_assets`	Add assets to a project
`nolgia_remove_project_asset`	Remove an asset from a project
`nolgia_list_canvases`	List canvases
`nolgia_get_canvas`	Get a canvas
`nolgia_create_canvas`	Create a canvas
`nolgia_update_canvas`	Update a canvas

Edit sessions and tweaks

Tool	What it does
`nolgia_list_tweak_scopes`	List image tweak scopes
`nolgia_create_edit_session`	Start an edit session
`nolgia_get_edit_session`	Read an edit session
`nolgia_edit_session_step`	Apply the next image edit
`nolgia_revert_edit_session`	Revert an edit session
`nolgia_estimate_edit_session`	Estimate the next edit

Presets

Tool	What it does
`nolgia_list_presets`	List presets
`nolgia_get_preset`	Get one preset

Timelines

Tool	What it does
`nolgia_validate_mask`	Validate a timeline mask
`nolgia_validate_motion`	Validate timeline motion
`nolgia_list_color_presets`	List color-grade presets
`nolgia_get_render`	Check a render

Desktop apps

Tool	What it does
`nolgia_app_status`	List connected desktop apps
`nolgia_app_info`	Read a desktop app's state
`nolgia_app_run`	Run code in a desktop app
`nolgia_app_command`	Check a desktop app command
`nolgia_app_preview`	Preview a desktop app's document
`nolgia_app_import`	Import an asset into a desktop app
`nolgia_app_export`	Export from a desktop app
`nolgia_app_save`	Save the document in a desktop app
`nolgia_app_open`	Open a document in a desktop app

Models, account and jobs

Tool	What it does
`nolgia_list_models`	List models
`nolgia_get_account`	Get the signed-in account
`nolgia_get_usage`	Get generation counts
`nolgia_cancel_job`	Cancel a generation job
`nolgia_list_jobs`	List generation jobs

Community #

Where	What for
GitHub	Public repositories and issues.
Contact	Reach the team.
Changelog	Read release updates.