Come installo la CLI nolgia?

Con npm (npm install -g @nolgia/cli), Homebrew (brew install nolgiainc/nolgia/nolgia), cargo (cargo install nolgia-cli) e curl (curl -fsSL https://raw.githubusercontent.com/nolgiainc/nolgia-cli/main/install.sh | bash). Tutti i canali seguono la stessa release.

Come accedo dal terminale?

Esegui nolgia auth login una volta. Apre un accesso del dispositivo nel browser e la CLI mantiene la sessione.

Posso vedere quanto costa un job prima di avviarlo?

Sì. Aggiungi --cost-only a qualsiasi generazione per ottenere la stima dei crediti senza spendere nulla.

Cosa può generare la CLI?

Immagini, video e audio con i modelli pubblicati dalla piattaforma, comprese sequenze video a più inquadrature con flag --shot ripetuti e video da un'immagine fissa.

Come collego Claude Code o un altro agente?

Punta il tuo client MCP su https://mcp.nolgia.ai/mcp con un header Authorization: Bearer che contiene un token di accesso personale, e tutti i 81 strumenti compaiono nel tuo agente.

La CLI e l'app condividono i crediti?

Se accedi con nolgia auth login, sì: la CLI consuma prima i crediti mensili del piano e poi i crediti di ricarica, come l'app. Un token di accesso personale (NOLGIA_TOKEN), usato anche dall'API e dal server MCP, consuma solo i crediti di ricarica. Un assistente che colleghi tramite OAuth, come ChatGPT o Claude, consuma come l'app.

Il mio agente di coding può configurare la CLI per me?

Sì. Copia l'istruzione di una riga sotto Incolla questo nel tuo agente. Indica al tuo agente di coding il runbook di installazione su https://github.com/nolgiainc/nolgia-cli/blob/main/INSTALL_FOR_AGENTS.md, che guida passo per passo tra installazione, autenticazione, skill e una generazione di verifica.

Come vedo quanto costerà un job?

Usa --cost-only nella CLI o POST /jobs/cost nell'API. Entrambi usano lo stesso calcolo dei prezzi e restituiscono la stessa stima dei crediti prima della generazione.

CLI e server MCP

Genera dal tuo terminale o dal tuo agente.

La CLI nolgia è un solo binario Rust per generare immagini, video e audio. Il server MCP di NOLGIA espone la stessa piattaforma a Claude Code e a qualsiasi altro agente. Un account, due modi per accedere.

$ npm install -g @nolgia/cli

Ottieni un token di accesso Collega un agente

Una giovane donna in pelliccia bianca scrive su una tastiera appoggiata sulle gambe, seduta su una pila di vecchi televisori in un parcheggio di notte, e ogni schermo mostra la palma che brucia alle sue spalle

Installa

Scegli il tuo package manager.

Un solo binario, quattro modi per ottenerlo. Tutti i canali seguono la stessa release.

$ npm install -g @nolgia/cli

Installa il binario precompilato per la tua piattaforma. Richiede Node 18+.

$ brew install nolgiainc/nolgia/nolgia

macOS e Linux. Segue l'ultima release con tag.

$ cargo install nolgia-cli

Compila dal sorgente con una toolchain Rust stabile.

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

Rileva il tuo sistema operativo e l'architettura, poi mette il binario nel tuo PATH.

Incolla questo nel tuo agente

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.

Il tuo agente di coding installa la CLI senza sudo, aspetta che ti autentichi, installa le skill ed esegue una generazione di verifica.

Leggi il runbook

Avvio rapido

Autenticati, poi genera.

Accedi una volta con nolgia auth login, poi genera con qualsiasi modello supportato. Componi sequenze a più inquadrature con flag --shot ripetuti, e passa --cost-only per conoscere il prezzo di un job prima di eseguirlo.

# 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

POST /jobs/cost dell'API restituisce lo stesso numero.

Creato per chi vive nel terminale.

Nessuna dashboard da tenere d'occhio. Tutto ciò che può fare lo Studio è a un comando o a una chiamata di strumento di distanza.

Un solo client per persone e agenti

La stessa piattaforma dietro il terminale e il server MCP. Scrivi tu gli script, oppure lascia che la usi Claude Code. Le funzionalità sono identiche.

Prezzi in crediti trasparenti

Aggiungi --cost-only a qualsiasi generazione per avere una stima dei crediti prima di spendere. Nessun conteggio a sorpresa, nessun moltiplicatore nascosto.

Modello di job asincrono

Ogni generazione è un job che puoi attendere o interrogare. Lancia un batch, vai a fare altro e raccogli i risultati quando arrivano.

Sequenze native a più inquadrature

Componi sequenze cinematografiche con flag --shot ripetuti. Dirigi campi larghi, piani medi e primi piani in un solo comando.

Da immagine a video ovunque

Genera video da un'immagine fissa su ogni modello compatibile con un unico set di flag coerente.

Funziona in Claude Code

Punta qualsiasi client MCP sul server ospitato con un bearer token e tutti gli strumenti compaiono nel tuo agente.

Server MCP

Dai al tuo agente l'intera piattaforma.

Il server MCP di NOLGIA è ospitato su https://mcp.nolgia.ai/mcp e usa il trasporto MCP Streamable HTTP. Autenticati con un PAT o un JWT come bearer e tutti i 81 strumenti diventano disponibili per Claude Code, Cursor o qualsiasi client MCP in grado di inviare un header. Gli assistenti che ti fanno accedere invece di accettare un token sono descritti nella pagina MCP.

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

Genera un token di accesso personale dal tuo account, poi inseriscilo nell'header Authorization. Riavvia il client per caricare il server.

81 strumenti, letti dal registro del server stesso

Generate

Generate: 17 strumenti
Strumento	Scopo
`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
`nolgia_analyze_reference`	Analyze a reference video

Your library

Your library: 25 strumenti
Strumento	Scopo
`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
`nolgia_get_reference_analysis`	Read a reference analysis
`nolgia_apply_look`	Apply a look to generations
`nolgia_look_from_analysis`	Make a look from a reference analysis
`nolgia_merge_look_analyses`	Teach a look from several videos
`nolgia_match_look`	Re-cut a timeline to a look
`nolgia_score_edit_dna`	Score a render against a look

Projects

Projects: 11 strumenti
Strumento	Scopo
`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 strumenti
Strumento	Scopo
`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 strumenti
Strumento	Scopo
`nolgia_list_presets`	List presets
`nolgia_get_preset`	Get one preset

Timelines

Timelines: 4 strumenti
Strumento	Scopo
`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: 11 strumenti
Strumento	Scopo
`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
`nolgia_app_dit`	Do the DIT on the person's computer
`nolgia_app_transcribe`	Transcribe clips in Premiere Pro

Models, account and jobs

Models, account and jobs: 5 strumenti
Strumento	Scopo
`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

Modelli

I modelli a cui si rivolge la CLI.

video

Wan 3.0

da 14 crediti per clip di 5 s

Vedi il modello

video

Hailuo 3

da 37 crediti per clip di 5 s

Vedi il modello

video

Seedance 2.5

da 26 crediti per clip di 5 s

Vedi il modello

immagine

GPT Image 2.5 Sunburst

da 8 crediti per immagine

Vedi il modello

immagine

Nano Banana 2.1

da 4 crediti per immagine

Vedi il modello

immagine

Grok Imagine 2.0

da 4 crediti per immagine

Vedi il modello

audio

ElevenLabs v3 Conversational

da 3 crediti per 1.000 caratteri

Vedi il modello

audio

Lyria 3.5

da 5 crediti per generazione

Vedi il modello

Esplora tutti i modelli

FAQ

Domande dal terminale.

Come installo la CLI nolgia?: Con npm (npm install -g @nolgia/cli), Homebrew (brew install nolgiainc/nolgia/nolgia), cargo (cargo install nolgia-cli) e curl (curl -fsSL https://raw.githubusercontent.com/nolgiainc/nolgia-cli/main/install.sh | bash). Tutti i canali seguono la stessa release.
Come accedo dal terminale?: Esegui nolgia auth login una volta. Apre un accesso del dispositivo nel browser e la CLI mantiene la sessione.
Posso vedere quanto costa un job prima di avviarlo?: Sì. Aggiungi --cost-only a qualsiasi generazione per ottenere la stima dei crediti senza spendere nulla.
Cosa può generare la CLI?: Immagini, video e audio con i modelli pubblicati dalla piattaforma, comprese sequenze video a più inquadrature con flag --shot ripetuti e video da un'immagine fissa.
Come collego Claude Code o un altro agente?: Punta il tuo client MCP su https://mcp.nolgia.ai/mcp con un header Authorization: Bearer che contiene un token di accesso personale, e tutti i 81 strumenti compaiono nel tuo agente.
La CLI e l'app condividono i crediti?: Se accedi con nolgia auth login, sì: la CLI consuma prima i crediti mensili del piano e poi i crediti di ricarica, come l'app. Un token di accesso personale (NOLGIA_TOKEN), usato anche dall'API e dal server MCP, consuma solo i crediti di ricarica. Un assistente che colleghi tramite OAuth, come ChatGPT o Claude, consuma come l'app.
Il mio agente di coding può configurare la CLI per me?: Sì. Copia l'istruzione di una riga sotto Incolla questo nel tuo agente. Indica al tuo agente di coding il runbook di installazione su https://github.com/nolgiainc/nolgia-cli/blob/main/INSTALL_FOR_AGENTS.md, che guida passo per passo tra installazione, autenticazione, skill e una generazione di verifica.
Come vedo quanto costerà un job?: Usa --cost-only nella CLI o POST /jobs/cost nell'API. Entrambi usano lo stesso calcolo dei prezzi e restituiscono la stessa stima dei crediti prima della generazione.

Collega un agente.

Crea un account, genera un token e punta la tua CLI o il tuo client MCP su NOLGIA. I primi crediti li offriamo noi.

Inizia · gratis Vedi i prezzi