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 dfe47a6..8c70634 100644 --- a/README.md +++ b/README.md @@ -1,11 +1,44 @@ -# 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) + +## 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 @@ -65,20 +98,33 @@ 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 "$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 | Command | Purpose | @@ -139,6 +185,18 @@ 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 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) +- ๐Ÿ” **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" },