Skip to content

AtlasCloudAI/cli

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

27 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Atlas Cloud CLI

One command to call 300+ LLM, image, and video models from your shell. Cross-platform Β· MCP-ready.

release npm downloads license stars PRs welcome

Atlas Cloud CLI demo

β†’ 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 Β»

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.

Quickstart

Generate your first image, video, and chat completion β€” one line each:

# Image
atlas generate image google/nano-banana-2/text-to-image -p "a cat astronaut, studio lighting"

# Video
atlas generate video bytedance/seedance-2.0-fast/text-to-video -p "a paper plane gliding over a neon city at dusk"

# Chat (LLM)
atlas chat "explain UUID v7"

# Browse the full catalog any time
atlas models list

First time only β€” authenticate with your API key:

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

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

More end-to-end scripts (minimal call β†’ real-world scenario β†’ multi-step pipeline) live in examples/.

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 Upcoming: account and billing endpoints are not available yet
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

License

MIT