Atlas Cloud CLI

June 17, 2026 · View on GitHub

Call Atlas Cloud LLM, image, video, and audio APIs from your shell, scripts, and CI jobs.

release npm downloads license stars PRs welcome

→ 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 — Seedance 2.0 · Kling 3 · Sora 2 · Veo 3.1 · HappyHorse 1 · Grok Imagine 1.5 · Wan 2.7

  • 🎨 Image — Nano Banana 2/Pro · GPT Image 2 · Flux 2 · Seedream 5

  • 💬 LLM — Claude · GPT · DeepSeek · MiniMax · Kimi · GLM · Qwen

  • 🔊 Audio — Grok TTS

  • 📚 Explore more — 300+ models »

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

Contents

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
JobCommand patternNotes
Discover available modelsatlas models list --type video --jsonReplace video with chat or image; avoid hard-coding stale model IDs.
Inspect model parametersatlas models get MODEL_ID --jsonRead required fields, defaults, and vendor-specific parameter names.
Estimate generation costatlas generate cost video MODEL_ID ... --jsonUse cost image or cost video; calls the pricing endpoint only.
Call a chat or multimodal modelatlas chat --model MODEL_ID "prompt"Supports text plus --image, --video, and --audio for capable models.
Start an image/video jobatlas generate image MODEL_ID ...Use generate image or generate video; add --no-wait --json for async scripts.
Continue an async jobatlas generate get PREDICTION_ID / atlas generate wait PREDICTION_IDPoll status or wait until completion.
Script and CI usageatlas --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.0-fast/text-to-video --json

Estimate cost before generation

atlas generate cost video bytedance/seedance-2.0-fast/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

CommandPurpose
atlas authLog in, log out, inspect local auth state
atlas chatSend a chat completion request
atlas modelsList and inspect available models
atlas generateGenerate images and videos, poll job status
atlas accountManage account selection
atlas versionPrint build information

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

Global Flags

FlagPurpose
--jsonForce machine-readable JSON output
--no-colorDisable ANSI color
--quietSuppress spinners and progress text
--verbosePrint 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

License

MIT