cli

Call Atlas Cloud LLM, image, and video APIs from your shell, scripts, and CI jobs — with image/video/audio inputs for multimodal chat.

→ Get your free Atlas Cloud API key — 300+ models, one key, OpenAI-compatible.

This repository hosts public installers, release artifacts, and lightweight package-manager wrappers for the atlas CLI. The Go source repository is maintained separately.

Supported Models

• 🎬 Video (177) — Seedance 2.5 · MiniMax H3 · Youchuan V8.2 · Seedance 2.0 Mini · HappyHorse-1.1 · Gemini Omni Flash

• 🎨 Image (118) — Grok Imagine Image 2.0 · Qwen Image 3.0 Pro · Seedream v5.0 Pro · Qwen Image 3.0

• 🧊 3D (7) — Seed3D 2.0 · Hunyuan 3D Rapid · Hunyuan 3D Pro · Tripo H3.1

• 💬 LLM (65) — Grok 4.6 · DeepSeek V4 Pro 0813 · DeepSeek V4 Flash 0731 · Qwen3.8 Max

• 📚 Explore more — all 395 live models »

🎬 Newest video models — Seedance 2.5 · Kling 4.0 · Wan 3.0 · Kling Video O3.

ℹ️ Audio: the CLI accepts audio as input for multimodal chat (atlas chat --audio @file.mp3, e.g. transcription with qwen/qwen3-vl-8b-instruct). Audio generation (TTS / music) and dedicated 3D/audio subcommands are not in the CLI yet — track #3 or use the MCP server / REST API meanwhile.

Availability, parameters, and pricing vary by model. Use atlas models get and atlas generate cost against the live catalog before automating billable calls.

Contents

• Supported Models
• Install
• API caller workflows
• Guides
• Commands
• Global Flags
• Updating
• Uninstall
• Troubleshooting
• Support
• More Atlas Cloud Tools
• License

Install

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/AtlasCloudAI/cli/main/install.sh | sh

Options:

INSTALLER=https://raw.githubusercontent.com/AtlasCloudAI/cli/main/install.sh

# Custom prefix, no sudo if the directory is writable
curl -fsSL "$INSTALLER" | sh -s -- --prefix="$HOME/.local"

The installer always uses the latest GitHub Release, downloads the matching archive, and verifies it against checksums.txt.

Windows

irm https://raw.githubusercontent.com/AtlasCloudAI/cli/main/install.ps1 | iex

Options:

# Custom install dir
$env:ATLAS_INSTALL_DIR="$HOME\bin"; irm https://raw.githubusercontent.com/AtlasCloudAI/cli/main/install.ps1 | iex

# Skip adding atlas.exe to user PATH
$env:ATLAS_NO_PATH="1"; irm https://raw.githubusercontent.com/AtlasCloudAI/cli/main/install.ps1 | iex

The Windows installer always uses the latest GitHub Release, downloads the matching windows_amd64 or windows_arm64 zip, verifies it against checksums.txt, installs atlas.exe, and adds the install directory to the user PATH by default.

Homebrew

brew install AtlasCloudAI/tap/atlascloud

The formula is named atlascloud, but it installs the atlas command.

npm

npm install -g atlascloud-cli

The npm package is a thin wrapper. Its postinstall script downloads the matching prebuilt release archive and verifies the checksum before exposing atlas.

Manual

Download the archive for your OS and architecture from Releases, extract it, and place the binaries in your PATH.

API caller workflows

Authenticate once, then choose the command path that matches the API call you want to make. Discovery and cost commands are safe to run before starting a billable generation.

atlas auth login                               # interactive
atlas auth login --token "$ATLASCLOUD_API_KEY" # CI / non-interactive
atlas auth status

Job	Command pattern	Notes
Discover available models	atlas models list --type video --json	Replace video with chat or image; avoid hard-coding stale model IDs.
Inspect model parameters	atlas models get MODEL_ID --json	Read required fields, defaults, and vendor-specific parameter names.
Estimate generation cost	atlas generate cost video MODEL_ID ... --json	Use cost image or cost video; calls the pricing endpoint only.
Call a chat or multimodal model	atlas chat --model MODEL_ID "prompt"	Supports text plus --image, --video, and --audio for capable models.
Start an image/video job	atlas generate image MODEL_ID ...	Use generate image or generate video; add --no-wait --json for async scripts.
Continue an async job	atlas generate get PREDICTION_ID / atlas generate wait PREDICTION_ID	Poll status or wait until completion.
Script and CI usage	atlas --json ... | jq ...	Non-TTY output is JSON by default; --json makes it explicit.

Explore without model calls

atlas models list --type video --json | jq -r '.models[].id'
atlas models search seedance --type video --json
atlas models get bytedance/seedance-2.5/text-to-video --json

Estimate cost before generation

atlas generate cost video bytedance/seedance-2.5/text-to-video \
  -p "A product shot slowly rotates on a clean white background" \
  --duration 5 \
  --resolution 720p \
  --param generate_audio=false \
  --json

Make API calls

atlas chat --model deepseek-ai/DeepSeek-V3-0324 "Return only a JSON object with status=ok"

PRED=$(atlas generate image google/nano-banana-2/text-to-image \
  -p "minimal product photo on a white background" \
  --no-wait --json | jq -r '.id')
atlas generate wait "$PRED"

Prefer environment variables? Copy .env.example to .env and set ATLASCLOUD_API_KEY.

More API caller scripts (discovery-first call → cost-aware generation → scripted pipeline → CI JSON job) live in examples/.

Guides

• API caller workflows — how to use Atlas CLI as a shell-first API client in local scripts, CI jobs, and backend automation.

Commands

Command	Purpose
atlas auth	Log in, log out, inspect local auth state
atlas chat	Send a chat completion request
atlas models	List and inspect available models
atlas generate	Generate images and videos, poll job status
atlas account	Manage account selection
atlas version	Print build information

Run atlas --help or atlas <command> --help for full flag reference.

Global Flags

Flag	Purpose
--json	Force machine-readable JSON output
--no-color	Disable ANSI color
--quiet	Suppress spinners and progress text
--verbose	Print debug output to stderr

Updating

# curl installer
curl -fsSL https://raw.githubusercontent.com/AtlasCloudAI/cli/main/install.sh | sh

# Homebrew
brew update && brew upgrade atlascloud

# npm
npm install -g atlascloud-cli@latest

Uninstall

# curl installer, default prefix
sudo rm -f /usr/local/bin/atlas

# Homebrew
brew uninstall atlascloud

# npm
npm uninstall -g atlascloud-cli

Troubleshooting

Not logged in — run atlas auth login.

Unknown model — run atlas models list or atlas models search <keyword>.

Installer checksum failure — do not run the downloaded archive. Retry the install or open an issue with the exact URL and version.

Support

Bugs and feature requests: GitHub Issues. Please include atlas version, your OS/arch, install method, and the exact command that failed.

More Atlas Cloud Tools

• 🧰 Want to use it from the terminal? → atlascloud-cli
• 🤖 Want to use it in Claude Code / Cursor? → Install the Atlas Cloud MCP Server
• 🎬 Want it as a Claude Code / Codex / Gemini CLI Skill? → Install atlas-cloud-skills
• 🎨 ComfyUI nodes → atlascloud_comfyui
• 🔁 n8n nodes → n8n-nodes-atlascloud
• 💬 Join our Discord → discord.gg/MWmMr4q9es
• 🌐 Website → atlascloud.ai

License

MIT