From 99637ec64e68f34d968628a956c59bdded5075cb Mon Sep 17 00:00:00 2001 From: lucaszhu-hue Date: Tue, 9 Jun 2026 16:59:09 +0800 Subject: [PATCH 1/3] =?UTF-8?q?docs:=20README=20revamp=20+=20assets=20(per?= =?UTF-8?q?=20=E5=B7=B2=E6=9C=89=20Repo=20=E4=BC=98=E5=8C=96=20to-do)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Stronger tagline, 5 badges, Supported Models, Get API Key CTA, Quickstart reorder, More Atlas Cloud Tools footer; new examples/ (3 layered scripts); npm keywords. Co-Authored-By: Claude Opus 4.8 --- README.md | 55 +++++++++++++++++++++++++++++++------ examples/01-minimal.sh | 12 ++++++++ examples/02-product-shot.sh | 15 ++++++++++ examples/03-pipeline.sh | 30 ++++++++++++++++++++ examples/README.md | 29 +++++++++++++++++++ npm/package.json | 20 +++++++++++++- 6 files changed, 152 insertions(+), 9 deletions(-) create mode 100755 examples/01-minimal.sh create mode 100755 examples/02-product-shot.sh create mode 100755 examples/03-pipeline.sh create mode 100644 examples/README.md diff --git a/README.md b/README.md index dfe47a6..39bb2ef 100644 --- a/README.md +++ b/README.md @@ -1,11 +1,30 @@ -# AtlasCloud CLI +# Atlas Cloud CLI -Call AtlasCloud LLM, image, and video models from your shell. +> One command to call 300+ LLM, image, and video models from your shell. Cross-platform ยท MCP-ready. -![AtlasCloud CLI demo](demo.gif) +

+ release + npm downloads + license + stars + PRs welcome +

+ +![Atlas Cloud CLI demo](demo.gif) + +> **[โ†’ Get your free Atlas Cloud API key](https://www.atlascloud.ai/console/api-keys?utm_source=github&utm_campaign=cli)** โ€” 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 ยป](https://www.atlascloud.ai/models?utm_source=github&utm_campaign=cli) + ## Install ### macOS / Linux @@ -65,20 +84,31 @@ Download the archive for your OS and architecture from [Releases](https://github ## Quickstart +Generate your first image, video, and chat completion โ€” one line each: + ```bash -atlas auth login +# 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 -atlas generate image google/nano-banana-2/text-to-image -p "a cat" ``` -For CI and non-interactive environments: +First time only โ€” authenticate with your [API key](https://www.atlascloud.ai/console/api-keys?utm_source=github&utm_campaign=cli): ```bash -atlas auth login --token "$ATLAS_API_KEY" -atlas chat "hi" --model deepseek-ai/DeepSeek-V3-0324 +atlas auth login # interactive +atlas auth login --token "$ATLAS_API_KEY" # CI / non-interactive ``` +More end-to-end scripts (minimal call โ†’ real-world scenario โ†’ multi-step pipeline) live in [`examples/`](examples/). + ## Commands | Command | Purpose | @@ -139,6 +169,15 @@ Installer checksum failure โ€” do not run the downloaded archive. Retry the inst Bugs and feature requests: [GitHub Issues](https://github.com/AtlasCloudAI/cli/issues). Please include `atlas version`, your OS/arch, install method, and the exact command that failed. +## More Atlas Cloud Tools + +- ๐Ÿค– **Want to use it in Claude Code / Cursor?** โ†’ Install the [Atlas Cloud MCP Server](https://github.com/AtlasCloudAI/mcp-server) +- ๐ŸŽฌ **Want it as a Claude Code / Codex / Gemini CLI Skill?** โ†’ Install [atlas-cloud-skills](https://github.com/AtlasCloudAI/atlas-cloud-skills) +- ๐ŸŽจ **ComfyUI nodes** โ†’ [atlascloud_comfyui](https://github.com/AtlasCloudAI/atlascloud_comfyui) +- ๐Ÿ” **n8n nodes** โ†’ [n8n-nodes-atlascloud](https://github.com/AtlasCloudAI/n8n-nodes-atlascloud) +- ๐Ÿ’ฌ **Join our Discord** โ†’ [discord.gg/MWmMr4q9es](https://discord.gg/MWmMr4q9es) +- ๐ŸŒ **Website** โ†’ [atlascloud.ai](https://www.atlascloud.ai?utm_source=github&utm_campaign=cli) + ## License MIT diff --git a/examples/01-minimal.sh b/examples/01-minimal.sh new file mode 100755 index 0000000..f372794 --- /dev/null +++ b/examples/01-minimal.sh @@ -0,0 +1,12 @@ +#!/usr/bin/env bash +# 01 โ€” Minimal call: one chat completion + one image. +# Prerequisite: `atlas auth login` (once). See examples/README.md. +set -euo pipefail + +echo "== Chat ==" +atlas chat "Give me three taglines for a productivity app. One line each." + +echo +echo "== Image ==" +atlas generate image google/nano-banana-2/text-to-image \ + -p "a minimalist productivity app icon, soft gradient, rounded square, 3D" diff --git a/examples/02-product-shot.sh b/examples/02-product-shot.sh new file mode 100755 index 0000000..3a0aa62 --- /dev/null +++ b/examples/02-product-shot.sh @@ -0,0 +1,15 @@ +#!/usr/bin/env bash +# 02 โ€” Real-world scenario: e-commerce product launch. +# Generate a hero image for a product, then write its marketing copy with an LLM. +# Prerequisite: `atlas auth login` (once). See examples/README.md. +set -euo pipefail + +PRODUCT="a matte-black stainless steel insulated water bottle" + +echo "== 1/2 Hero image ==" +atlas generate image bytedance/seedream-v4.5 \ + -p "studio product photo of ${PRODUCT}, on a marble surface, soft window light, shallow depth of field, e-commerce hero shot, 4k" + +echo +echo "== 2/2 Marketing copy ==" +atlas chat "Write a 40-word product description and 5 bullet features for ${PRODUCT}. Tone: premium, minimal." diff --git a/examples/03-pipeline.sh b/examples/03-pipeline.sh new file mode 100755 index 0000000..29943ac --- /dev/null +++ b/examples/03-pipeline.sh @@ -0,0 +1,30 @@ +#!/usr/bin/env bash +# 03 โ€” Pipeline: one idea -> LLM storyboard -> image AND video, chained. +# Uses the LLM to expand a single idea into detailed prompts, then feeds those +# prompts straight into image + video generation. Only documented commands. +# Prerequisite: `atlas auth login` (once). See examples/README.md. +set -euo pipefail + +IDEA="${1:-a cozy independent coffee shop on a rainy evening}" +echo "Idea: ${IDEA}" +echo + +echo "== 1/4 Expand idea into an image prompt (LLM) ==" +IMAGE_PROMPT="$(atlas chat "Turn this idea into ONE vivid text-to-image prompt (single line, no preamble): ${IDEA}")" +echo "Image prompt: ${IMAGE_PROMPT}" + +echo +echo "== 2/4 Generate the still ==" +atlas generate image google/nano-banana-2/text-to-image -p "${IMAGE_PROMPT}" + +echo +echo "== 3/4 Expand idea into a 5s cinematic video prompt (LLM) ==" +VIDEO_PROMPT="$(atlas chat "Turn this idea into ONE 5-second cinematic text-to-video prompt with a camera move (single line, no preamble): ${IDEA}")" +echo "Video prompt: ${VIDEO_PROMPT}" + +echo +echo "== 4/4 Generate the clip ==" +atlas generate video bytedance/seedance-2.0-fast/text-to-video -p "${VIDEO_PROMPT}" + +echo +echo "Done. Tip: add --json to any command to capture IDs/URLs for further automation." diff --git a/examples/README.md b/examples/README.md new file mode 100644 index 0000000..d35d44e --- /dev/null +++ b/examples/README.md @@ -0,0 +1,29 @@ +# Atlas Cloud CLI โ€” Examples + +Three layered, copy-pasteable scripts. Each is self-contained and uses only +documented `atlas` commands (`auth`, `chat`, `models`, `generate`). + +| Script | Layer | What it shows | +|---|---|---| +| [`01-minimal.sh`](01-minimal.sh) | Minimal call | The smallest possible chat + image generation. | +| [`02-product-shot.sh`](02-product-shot.sh) | Real-world scenario | E-commerce: generate a product hero image, then write its marketing copy with an LLM. | +| [`03-pipeline.sh`](03-pipeline.sh) | Pipeline | Idea โ†’ LLM storyboard โ†’ image **and** video, chained end-to-end. | + +## Prerequisites + +1. Install the CLI โ€” see the [root README](../README.md#install). +2. Authenticate once: + + ```bash + atlas auth login # interactive + atlas auth login --token "$ATLASCLOUD_API_KEY" # CI / non-interactive + ``` + + Get a free key at the [Atlas Cloud console](https://www.atlascloud.ai/console/api-keys?utm_source=github&utm_campaign=cli). + +## Run + +```bash +chmod +x examples/*.sh +./examples/01-minimal.sh +``` diff --git a/npm/package.json b/npm/package.json index ced149e..5ae1a7e 100644 --- a/npm/package.json +++ b/npm/package.json @@ -1,7 +1,25 @@ { "name": "atlascloud-cli", "version": "0.1.13", - "description": "AtlasCloud CLI โ€” call LLM, image, and video models from your terminal.", + "description": "One command to generate AI images, videos & chat with 300+ models. GPT Image 2, Nano Banana 2/Pro, Kling 3, Seedance 2, Flux 2, Claude, GPT, DeepSeek API CLI.", + "keywords": [ + "atlascloud", + "atlas-cloud", + "ai-api", + "ai-cli", + "sora-2", + "veo-3", + "kling-3", + "seedance-2", + "flux-2", + "nano-banana", + "gpt-image-2", + "mcp-server", + "ai-video-generation", + "text-to-image", + "text-to-video", + "generative-ai" + ], "bin": { "atlas": "bin/atlas.js" }, From 2f81e5972816a7000b23b5a0fe80cb386f4ca077 Mon Sep 17 00:00:00 2001 From: lucaszhu-hue Date: Wed, 10 Jun 2026 10:25:01 +0800 Subject: [PATCH 2/3] fix: address Lark spec audit gaps (TOC, More Atlas Cloud Tools 7 bullets, UTM, .env.example) --- .env.example | 2 ++ README.md | 19 ++++++++++++++++++- 2 files changed, 20 insertions(+), 1 deletion(-) create mode 100644 .env.example diff --git a/.env.example b/.env.example new file mode 100644 index 0000000..fd17b38 --- /dev/null +++ b/.env.example @@ -0,0 +1,2 @@ +# Get your free key: https://www.atlascloud.ai/console/api-keys?utm_source=github&utm_campaign=cli +ATLASCLOUD_API_KEY=your-api-key-here diff --git a/README.md b/README.md index 39bb2ef..e979e65 100644 --- a/README.md +++ b/README.md @@ -25,6 +25,20 @@ This repository hosts public installers, release artifacts, and lightweight pack - ๐Ÿ“š **Explore more** โ€” [300+ models ยป](https://www.atlascloud.ai/models?utm_source=github&utm_campaign=cli) +## Contents + +- [Supported Models](#supported-models) +- [Install](#install) +- [Quickstart](#quickstart) +- [Commands](#commands) +- [Global Flags](#global-flags) +- [Updating](#updating) +- [Uninstall](#uninstall) +- [Troubleshooting](#troubleshooting) +- [Support](#support) +- [More Atlas Cloud Tools](#more-atlas-cloud-tools) +- [License](#license) + ## Install ### macOS / Linux @@ -104,9 +118,11 @@ First time only โ€” authenticate with your [API key](https://www.atlascloud.ai/c ```bash atlas auth login # interactive -atlas auth login --token "$ATLAS_API_KEY" # CI / non-interactive +atlas auth login --token "$ATLASCLOUD_API_KEY" # CI / non-interactive ``` +Prefer environment variables? Copy [`.env.example`](.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/`](examples/). ## Commands @@ -171,6 +187,7 @@ Bugs and feature requests: [GitHub Issues](https://github.com/AtlasCloudAI/cli/i ## More Atlas Cloud Tools +- ๐Ÿงฐ **Want to use it from the terminal?** โ†’ [atlascloud-cli](https://github.com/AtlasCloudAI/cli) - ๐Ÿค– **Want to use it in Claude Code / Cursor?** โ†’ Install the [Atlas Cloud MCP Server](https://github.com/AtlasCloudAI/mcp-server) - ๐ŸŽฌ **Want it as a Claude Code / Codex / Gemini CLI Skill?** โ†’ Install [atlas-cloud-skills](https://github.com/AtlasCloudAI/atlas-cloud-skills) - ๐ŸŽจ **ComfyUI nodes** โ†’ [atlascloud_comfyui](https://github.com/AtlasCloudAI/atlascloud_comfyui) From 60ef958e9a63dcbf0a3bd95cfb7d0f518cb167a9 Mon Sep 17 00:00:00 2001 From: lucaszhu-hue Date: Wed, 10 Jun 2026 12:19:59 +0800 Subject: [PATCH 3/3] docs: add hero screenshot TODO placeholder at end of README --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index e979e65..8c70634 100644 --- a/README.md +++ b/README.md @@ -198,3 +198,5 @@ Bugs and feature requests: [GitHub Issues](https://github.com/AtlasCloudAI/cli/i ## License MIT + +