How do I install the nolgia CLI?

With npm (npm install -g @nolgia/cli), Homebrew (brew install nolgiainc/nolgia/nolgia), cargo (cargo install nolgia-cli), and curl (curl -fsSL https://raw.githubusercontent.com/nolgiainc/nolgia-cli/main/install.sh | bash). All channels track the same release.

How do I sign in from the terminal?

Run nolgia auth login once. It opens a device login in your browser and the CLI keeps the session.

Can I see what a job costs before I run it?

Yes. Add --cost-only to any generation to get the credit estimate without spending anything.

What can the CLI generate?

Images, video and audio on the models the platform publishes, including multi-shot video sequences from repeated --shot flags and video from a still image.

How do I connect Claude Code or another agent?

Point your MCP client at https://mcp.nolgia.ai/mcp with an Authorization: Bearer header carrying a personal access token, and all 72 tools show up in your agent.

Do the CLI and the app share credits?

When you sign in with nolgia auth login, yes: the CLI spends your monthly plan credits first and then your top-up credits, like the app. A personal access token (NOLGIA_TOKEN), which the API and the MCP server also use, spends top-up credits only. An assistant you connect over OAuth, such as ChatGPT or Claude, spends like the app.

Can my coding agent set the CLI up for me?

Yes. Copy the one-line instruction under Paste this into your agent. It points your coding agent to the installation runbook at https://github.com/nolgiainc/nolgia-cli/blob/main/INSTALL_FOR_AGENTS.md, which walks through installation, authentication, skills and a verify generation.

How do I see what a job will cost?

Use --cost-only on the CLI or POST /jobs/cost on the API. Both use the same pricer and return the same credit estimate before you generate.

CLI & MCP Server

Generate from your terminal, or from your agent.

The nolgia CLI is a single Rust binary for image, video, and audio generation. The NOLGIA MCP server exposes the same platform to Claude Code and any other agent. One account, two ways in.

$ npm install -g @nolgia/cli

Get an access token Connect an agent

A cinematic terminal workspace for creating with NOLGIA

Install

Pick your package manager.

One binary, four ways to get it. All channels track the same release.

$ npm install -g @nolgia/cli

Installs the prebuilt binary for your platform. Requires Node 18+.

$ brew install nolgiainc/nolgia/nolgia

macOS and Linux. Tracks the latest tagged release.

$ cargo install nolgia-cli

Builds from source with a stable Rust toolchain.

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

Detects your OS and architecture, then drops the binary on your PATH.

Paste this into your agent

Read https://raw.githubusercontent.com/nolgiainc/nolgia-cli/main/INSTALL_FOR_AGENTS.md and follow it end to end to install and set up the Nolgia CLI for me.

Your coding agent installs the CLI without sudo, waits while you authenticate, installs the skills, and runs one verify generation.

Read the runbook

Quick start

Authenticate, then generate.

Log in once with nolgia auth login, then generate against any supported model. Compose multi-shot sequences with repeated --shot flags, and pass --cost-only to price a job before you run it.

# Authenticate once: opens a device login in your browser
$ nolgia auth login

# Generate an 8-second clip from a prompt
$ nolgia gen video \
  --model veo-3.1 \
  --prompt "a street bike carving a coastal road at dusk" \
  --duration-seconds 8 \
  --out clip.mp4

# Direct a multi-shot sequence: one --shot per beat.
# Add --cost-only first to see the credit estimate before spending.
$ nolgia gen video \
  --model veo-3.1 \
  --shot "8:WIDE SHOT: city skyline at golden hour, slow push in" \
  --shot "6:MEDIUM SHOT: rider mounts the bike, engine catches" \
  --shot "8:CLOSE UP: throttle twists, headlight flares" \
  --out sequence.mp4 \
  --cost-only

$ nolgia gen video --model veo-3.1 --prompt "…" --cost-only

The API's POST /jobs/cost returns the same number.

Built for people who live in the terminal.

No dashboards to babysit. Everything the Studio can do is a command or a tool call away.

One client for humans and agents

The same platform behind the terminal and the MCP server. Script it by hand, or let Claude Code drive it. The capabilities are identical.

Transparent credit pricing

Add --cost-only to any generation to get a credit estimate before you spend. No surprise metering, no hidden multipliers.

Async job model

Every generation is a job you can wait on or poll. Fire a batch, walk away, and collect the outputs when they land.

Native multi-shot sequences

Compose cinematic sequences from repeated --shot flags. Direct wide, medium, and close-up beats in a single command.

Image-to-video everywhere

Drive video from a still on every capable model with one consistent flag set.

Works in Claude Code

Point any MCP client at the hosted server with a bearer token and the full tool surface shows up in your agent.

MCP server

Give your agent the whole platform.

The NOLGIA MCP server is hosted at https://mcp.nolgia.ai/mcp and speaks the MCP Streamable HTTP transport. Authenticate with a bearer PAT or JWT and all 72 tools become available to Claude Code, Cursor, or any MCP client that can send a header. Assistants that sign you in instead of taking a token are covered on the MCP page.

{
  "mcpServers": {
    "nolgia": {
      "url": "https://mcp.nolgia.ai/mcp",
      "headers": {
        "Authorization": "Bearer nol_your_token_here"
      }
    }
  }
}

Generate a personal access token from your account, then drop it into the Authorization header. Restart your client to pick up the server.

72 tools, read from the server's own registry

Generate

Generate: 16 tools
Tool	Purpose
`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

Your library: 19 tools
Tool	Purpose
`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

Projects: 11 tools
Tool	Purpose
`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

Edit sessions and tweaks: 6 tools
Tool	Purpose
`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

Presets: 2 tools
Tool	Purpose
`nolgia_list_presets`	List presets
`nolgia_get_preset`	Get one preset

Timelines

Timelines: 4 tools
Tool	Purpose
`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

Desktop apps: 9 tools
Tool	Purpose
`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

Models, account and jobs: 5 tools
Tool	Purpose
`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

Models

The models the CLI routes to.

video

Wan 3.0

from 14 credits per 5s clip

See the model

video

Seedance 2.5

from 26 credits per 5s clip

See the model

video

Hailuo 3

from 37 credits per 5s clip

See the model

image

GPT Image 2.5 Sunburst

from 8 credits per image

See the model

image

MAI Image 2.6

from 6 credits per image

See the model

image

Nano Banana 2

from 4 credits per image

See the model

audio

ElevenLabs v3

from 6 credits per 1,000 characters

See the model

audio

Lyria 3.5

from 5 credits per generation

See the model

Explore all models

FAQ

Questions from the terminal.

How do I install the nolgia CLI?: With npm (npm install -g @nolgia/cli), Homebrew (brew install nolgiainc/nolgia/nolgia), cargo (cargo install nolgia-cli), and curl (curl -fsSL https://raw.githubusercontent.com/nolgiainc/nolgia-cli/main/install.sh | bash). All channels track the same release.
How do I sign in from the terminal?: Run nolgia auth login once. It opens a device login in your browser and the CLI keeps the session.
Can I see what a job costs before I run it?: Yes. Add --cost-only to any generation to get the credit estimate without spending anything.
What can the CLI generate?: Images, video and audio on the models the platform publishes, including multi-shot video sequences from repeated --shot flags and video from a still image.
How do I connect Claude Code or another agent?: Point your MCP client at https://mcp.nolgia.ai/mcp with an Authorization: Bearer header carrying a personal access token, and all 72 tools show up in your agent.
Do the CLI and the app share credits?: When you sign in with nolgia auth login, yes: the CLI spends your monthly plan credits first and then your top-up credits, like the app. A personal access token (NOLGIA_TOKEN), which the API and the MCP server also use, spends top-up credits only. An assistant you connect over OAuth, such as ChatGPT or Claude, spends like the app.
Can my coding agent set the CLI up for me?: Yes. Copy the one-line instruction under Paste this into your agent. It points your coding agent to the installation runbook at https://github.com/nolgiainc/nolgia-cli/blob/main/INSTALL_FOR_AGENTS.md, which walks through installation, authentication, skills and a verify generation.
How do I see what a job will cost?: Use --cost-only on the CLI or POST /jobs/cost on the API. Both use the same pricer and return the same credit estimate before you generate.

Connect an agent.

Create an account, mint a token, and point your CLI or MCP client at NOLGIA. The first credits are on us.

Get started · free View pricing