acedata-luma-cli 2026.3.17.0__tar.gz

acedata_luma_cli-2026.3.17.0/.env.example

@@ -0,0 +1,5 @@
+# Luma CLI Environment
+ACEDATACLOUD_API_TOKEN=your_api_token_here
+# ACEDATACLOUD_API_BASE_URL=https://api.acedata.cloud
+# LUMA_DEFAULT_MODEL=luma
+# LUMA_REQUEST_TIMEOUT=1800

acedata_luma_cli-2026.3.17.0/.gitignore

@@ -0,0 +1,32 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Distribution / packaging
+dist/
+build/
+*.egg-info/
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+
+# Environment variables
+.env
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# Testing
+.coverage
+htmlcov/
+.pytest_cache/
+
+# mypy
+.mypy_cache/

acedata_luma_cli-2026.3.17.0/CHANGELOG.md

@@ -0,0 +1,18 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Calendar Versioning](https://calver.org/) (YYYY.MM.DD.BUILD).
+
+## [0.1.0] - 2026-03-18
+
+### Added
+- Initial release
+- Luma video generation from text prompts
+- Image-to-video generation
+- Video extension
+- Task management with polling
+- Rich terminal output with tables and panels
+- JSON output mode (`--json` flag)
+- Multiple model support

acedata_luma_cli-2026.3.17.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AceDataCloud
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

acedata_luma_cli-2026.3.17.0/PKG-INFO

@@ -0,0 +1,267 @@
+Metadata-Version: 2.1
+Name: acedata-luma-cli
+Version: 2026.3.17.0
+Summary: CLI tool for Luma Dream Machine AI Video Generation via AceDataCloud API
+Project-URL: Homepage, https://github.com/AceDataCloud/LumaCli
+Project-URL: Repository, https://github.com/AceDataCloud/LumaCli
+Project-URL: Issues, https://github.com/AceDataCloud/LumaCli/issues
+Project-URL: Changelog, https://github.com/AceDataCloud/LumaCli/blob/main/CHANGELOG.md
+Author-email: AceDataCloud <support@acedata.cloud>
+Maintainer-email: AceDataCloud <support@acedata.cloud>
+License: MIT
+License-File: LICENSE
+Keywords: acedata,ai,cli,command-line,generation,luma,video
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Multimedia :: Video
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Requires-Dist: click>=8.1.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: rich>=13.0.0
+Provides-Extra: all
+Requires-Dist: luma-cli[dev,release,test]; extra == 'all'
+Provides-Extra: dev
+Requires-Dist: mypy>=1.10.0; extra == 'dev'
+Requires-Dist: pre-commit>=3.7.0; extra == 'dev'
+Requires-Dist: ruff>=0.4.0; extra == 'dev'
+Provides-Extra: release
+Requires-Dist: build>=1.2.0; extra == 'release'
+Requires-Dist: twine>=6.1.0; extra == 'release'
+Provides-Extra: test
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'test'
+Requires-Dist: pytest-cov>=5.0.0; extra == 'test'
+Requires-Dist: pytest>=8.0.0; extra == 'test'
+Requires-Dist: respx>=0.21.0; extra == 'test'
+Description-Content-Type: text/markdown
+
+# Luma CLI
+
+[![PyPI version](https://img.shields.io/pypi/v/acedata-acedata-luma-cli.svg)](https://pypi.org/project/acedata-acedata-luma-cli/)
+[![PyPI downloads](https://img.shields.io/pypi/dm/acedata-acedata-luma-cli.svg)](https://pypi.org/project/acedata-acedata-luma-cli/)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![CI](https://github.com/AceDataCloud/LumaCli/actions/workflows/ci.yaml/badge.svg)](https://github.com/AceDataCloud/LumaCli/actions/workflows/ci.yaml)
+
+A command-line tool for AI video generation using [Luma](https://platform.acedata.cloud/) through the [AceDataCloud API](https://platform.acedata.cloud/).
+
+Generate AI videos directly from your terminal — no MCP client required.
+
+## Features
+
+- **Video Generation** — Generate videos from text prompts with multiple models
+- **Image-to-Video** — Create videos from reference images- **Video Extension** — Extend existing videos
+- **Multiple Models** — luma
+- **Task Management** — Query tasks, batch query, wait with polling
+- **Rich Output** — Beautiful terminal tables and panels via Rich
+- **JSON Mode** — Machine-readable output with `--json` for piping
+
+## Quick Start
+
+### 1. Get API Token
+
+Get your API token from [AceDataCloud Platform](https://platform.acedata.cloud/):
+
+1. Sign up or log in
+2. Navigate to the Luma API page
+3. Click "Acquire" to get your token
+
+### 2. Install
+
+```bash
+# Install with pip
+pip install acedata-acedata-luma-cli
+
+# Or with uv (recommended)
+uv pip install acedata-acedata-luma-cli
+
+# Or from source
+git clone https://github.com/AceDataCloud/LumaCli.git
+cd LumaCli
+pip install -e .
+```
+
+### 3. Configure
+
+```bash
+# Set your API token
+export ACEDATACLOUD_API_TOKEN=your_token_here
+
+# Or use .env file
+cp .env.example .env
+# Edit .env with your token
+```
+
+### 4. Use
+
+```bash
+# Generate a video
+luma generate "A test video"
+
+# Generate from reference image
+luma image-to-video "Animate this scene" -i https://example.com/photo.jpg
+
+# Extend a video
+luma extend <video-id>
+
+# Check task status
+luma task <task-id>
+
+# Wait for completion
+luma wait <task-id> --interval 5
+
+# List available models
+luma models
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `luma generate <prompt>` | Generate a video from a text prompt |
+| `luma image-to-video <prompt> -i <url>` | Generate a video from reference image(s) |
+| `luma extend <video_id>` | Extend an existing video |
+| `luma task <task_id>` | Query a single task status |
+| `luma tasks <id1> <id2>...` | Query multiple tasks at once |
+| `luma wait <task_id>` | Wait for task completion with polling |
+| `luma models` | List available Luma models |
+| `luma config` | Show current configuration |
+| `luma aspect-ratios` | List available aspect ratios |
+
+
+## Global Options
+
+```
+--token TEXT    API token (or set ACEDATACLOUD_API_TOKEN env var)
+--version       Show version
+--help          Show help message
+```
+
+Most commands support:
+
+```
+--json          Output raw JSON (for piping/scripting)
+--model TEXT    Luma model version (default: luma)
+```
+
+## Available Models
+
+| Model | Version | Notes |
+|-------|---------|-------|
+| `luma` | Standard | Standard quality video generation (default) |
+
+
+## Configuration
+
+### Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `ACEDATACLOUD_API_TOKEN` | API token from AceDataCloud | *Required* |
+| `ACEDATACLOUD_API_BASE_URL` | API base URL | `https://api.acedata.cloud` |
+| `LUMA_DEFAULT_MODEL` | Default model | `luma` |
+| `LUMA_REQUEST_TIMEOUT` | Timeout in seconds | `1800` |
+
+## Development
+
+### Setup Development Environment
+
+```bash
+git clone https://github.com/AceDataCloud/LumaCli.git
+cd LumaCli
+python -m venv .venv
+source .venv/bin/activate
+pip install -e ".[dev,test]"
+```
+
+### Run Tests
+
+```bash
+pytest
+pytest --cov=luma_cli
+pytest tests/test_integration.py -m integration
+```
+
+### Code Quality
+
+```bash
+ruff format .
+ruff check .
+mypy luma_cli
+```
+
+## Docker
+
+```bash
+docker pull ghcr.io/acedatacloud/acedata-acedata-luma-cli:latest
+docker run --rm -e ACEDATACLOUD_API_TOKEN=your_token \
+  ghcr.io/acedatacloud/acedata-acedata-luma-cli generate "A test video"
+```
+
+## Project Structure
+
+```
+LumaCli/
+├── luma_cli/                # Main package
+│   ├── __init__.py
+│   ├── __main__.py            # python -m luma_cli entry point
+│   ├── main.py                # CLI entry point
+│   ├── core/                  # Core modules
+│   │   ├── client.py          # HTTP client for Luma API
+│   │   ├── config.py          # Configuration management
+│   │   ├── exceptions.py      # Custom exceptions
+│   │   └── output.py          # Rich terminal formatting
+│   └── commands/              # CLI command groups
+│       ├── video.py           # Video generation commands
+│       ├── task.py            # Task management commands
+│       └── info.py            # Info & utility commands
+├── tests/                     # Test suite
+├── .github/workflows/         # CI/CD (lint, test, publish to PyPI)
+├── Dockerfile                 # Container image
+├── deploy/                    # Kubernetes deployment configs
+├── .env.example               # Environment template
+├── pyproject.toml             # Project configuration
+└── README.md
+```
+
+## Luma CLI vs MCP Luma
+
+| Feature | Luma CLI | MCP Luma |
+|---------|-----------|-----------|
+| Interface | Terminal commands | MCP protocol |
+| Usage | Direct shell, scripts, CI/CD | Claude, VS Code, MCP clients |
+| Output | Rich tables / JSON | Structured MCP responses |
+| Automation | Shell scripts, piping | AI agent workflows |
+| Install | `pip install acedata-acedata-luma-cli` | `pip install mcp-luma` |
+
+Both tools use the same AceDataCloud API and share the same API token.
+
+## Contributing
+
+Contributions are welcome! Please:
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing`)
+3. Commit your changes (`git commit -m 'Add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing`)
+5. Open a Pull Request
+
+### Development Requirements
+
+- Python 3.10+
+- Dependencies: `pip install -e ".[all]"`
+- Lint: `ruff check . && ruff format --check .`
+- Test: `pytest`
+
+## License
+
+This project is licensed under the MIT License — see the [LICENSE](LICENSE) file for details.

acedata_luma_cli-2026.3.17.0/README.md

@@ -0,0 +1,221 @@
+# Luma CLI
+
+[![PyPI version](https://img.shields.io/pypi/v/acedata-acedata-luma-cli.svg)](https://pypi.org/project/acedata-acedata-luma-cli/)
+[![PyPI downloads](https://img.shields.io/pypi/dm/acedata-acedata-luma-cli.svg)](https://pypi.org/project/acedata-acedata-luma-cli/)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![CI](https://github.com/AceDataCloud/LumaCli/actions/workflows/ci.yaml/badge.svg)](https://github.com/AceDataCloud/LumaCli/actions/workflows/ci.yaml)
+
+A command-line tool for AI video generation using [Luma](https://platform.acedata.cloud/) through the [AceDataCloud API](https://platform.acedata.cloud/).
+
+Generate AI videos directly from your terminal — no MCP client required.
+
+## Features
+
+- **Video Generation** — Generate videos from text prompts with multiple models
+- **Image-to-Video** — Create videos from reference images- **Video Extension** — Extend existing videos
+- **Multiple Models** — luma
+- **Task Management** — Query tasks, batch query, wait with polling
+- **Rich Output** — Beautiful terminal tables and panels via Rich
+- **JSON Mode** — Machine-readable output with `--json` for piping
+
+## Quick Start
+
+### 1. Get API Token
+
+Get your API token from [AceDataCloud Platform](https://platform.acedata.cloud/):
+
+1. Sign up or log in
+2. Navigate to the Luma API page
+3. Click "Acquire" to get your token
+
+### 2. Install
+
+```bash
+# Install with pip
+pip install acedata-acedata-luma-cli
+
+# Or with uv (recommended)
+uv pip install acedata-acedata-luma-cli
+
+# Or from source
+git clone https://github.com/AceDataCloud/LumaCli.git
+cd LumaCli
+pip install -e .
+```
+
+### 3. Configure
+
+```bash
+# Set your API token
+export ACEDATACLOUD_API_TOKEN=your_token_here
+
+# Or use .env file
+cp .env.example .env
+# Edit .env with your token
+```
+
+### 4. Use
+
+```bash
+# Generate a video
+luma generate "A test video"
+
+# Generate from reference image
+luma image-to-video "Animate this scene" -i https://example.com/photo.jpg
+
+# Extend a video
+luma extend <video-id>
+
+# Check task status
+luma task <task-id>
+
+# Wait for completion
+luma wait <task-id> --interval 5
+
+# List available models
+luma models
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `luma generate <prompt>` | Generate a video from a text prompt |
+| `luma image-to-video <prompt> -i <url>` | Generate a video from reference image(s) |
+| `luma extend <video_id>` | Extend an existing video |
+| `luma task <task_id>` | Query a single task status |
+| `luma tasks <id1> <id2>...` | Query multiple tasks at once |
+| `luma wait <task_id>` | Wait for task completion with polling |
+| `luma models` | List available Luma models |
+| `luma config` | Show current configuration |
+| `luma aspect-ratios` | List available aspect ratios |
+
+
+## Global Options
+
+```
+--token TEXT    API token (or set ACEDATACLOUD_API_TOKEN env var)
+--version       Show version
+--help          Show help message
+```
+
+Most commands support:
+
+```
+--json          Output raw JSON (for piping/scripting)
+--model TEXT    Luma model version (default: luma)
+```
+
+## Available Models
+
+| Model | Version | Notes |
+|-------|---------|-------|
+| `luma` | Standard | Standard quality video generation (default) |
+
+
+## Configuration
+
+### Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `ACEDATACLOUD_API_TOKEN` | API token from AceDataCloud | *Required* |
+| `ACEDATACLOUD_API_BASE_URL` | API base URL | `https://api.acedata.cloud` |
+| `LUMA_DEFAULT_MODEL` | Default model | `luma` |
+| `LUMA_REQUEST_TIMEOUT` | Timeout in seconds | `1800` |
+
+## Development
+
+### Setup Development Environment
+
+```bash
+git clone https://github.com/AceDataCloud/LumaCli.git
+cd LumaCli
+python -m venv .venv
+source .venv/bin/activate
+pip install -e ".[dev,test]"
+```
+
+### Run Tests
+
+```bash
+pytest
+pytest --cov=luma_cli
+pytest tests/test_integration.py -m integration
+```
+
+### Code Quality
+
+```bash
+ruff format .
+ruff check .
+mypy luma_cli
+```
+
+## Docker
+
+```bash
+docker pull ghcr.io/acedatacloud/acedata-acedata-luma-cli:latest
+docker run --rm -e ACEDATACLOUD_API_TOKEN=your_token \
+  ghcr.io/acedatacloud/acedata-acedata-luma-cli generate "A test video"
+```
+
+## Project Structure
+
+```
+LumaCli/
+├── luma_cli/                # Main package
+│   ├── __init__.py
+│   ├── __main__.py            # python -m luma_cli entry point
+│   ├── main.py                # CLI entry point
+│   ├── core/                  # Core modules
+│   │   ├── client.py          # HTTP client for Luma API
+│   │   ├── config.py          # Configuration management
+│   │   ├── exceptions.py      # Custom exceptions
+│   │   └── output.py          # Rich terminal formatting
+│   └── commands/              # CLI command groups
+│       ├── video.py           # Video generation commands
+│       ├── task.py            # Task management commands
+│       └── info.py            # Info & utility commands
+├── tests/                     # Test suite
+├── .github/workflows/         # CI/CD (lint, test, publish to PyPI)
+├── Dockerfile                 # Container image
+├── deploy/                    # Kubernetes deployment configs
+├── .env.example               # Environment template
+├── pyproject.toml             # Project configuration
+└── README.md
+```
+
+## Luma CLI vs MCP Luma
+
+| Feature | Luma CLI | MCP Luma |
+|---------|-----------|-----------|
+| Interface | Terminal commands | MCP protocol |
+| Usage | Direct shell, scripts, CI/CD | Claude, VS Code, MCP clients |
+| Output | Rich tables / JSON | Structured MCP responses |
+| Automation | Shell scripts, piping | AI agent workflows |
+| Install | `pip install acedata-acedata-luma-cli` | `pip install mcp-luma` |
+
+Both tools use the same AceDataCloud API and share the same API token.
+
+## Contributing
+
+Contributions are welcome! Please:
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing`)
+3. Commit your changes (`git commit -m 'Add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing`)
+5. Open a Pull Request
+
+### Development Requirements
+
+- Python 3.10+
+- Dependencies: `pip install -e ".[all]"`
+- Lint: `ruff check . && ruff format --check .`
+- Test: `pytest`
+
+## License
+
+This project is licensed under the MIT License — see the [LICENSE](LICENSE) file for details.

acedata_luma_cli-2026.3.17.0/luma_cli/__init__.py

@@ -0,0 +1 @@
+"""Luma CLI - AI Luma Video Generation via AceDataCloud API."""

acedata_luma_cli-2026.3.17.0/luma_cli/__main__.py

@@ -0,0 +1,5 @@
+"""Allow running as python -m luma_cli."""
+
+from luma_cli.main import cli
+
+cli()

acedata_luma_cli-2026.3.17.0/luma_cli/commands/__init__.py

@@ -0,0 +1 @@
+"""Luma CLI command modules."""

acedata_luma_cli-2026.3.17.0/luma_cli/commands/info.py

@@ -0,0 +1,53 @@
+"""Info and utility commands."""
+
+import click
+
+from luma_cli.core.config import settings
+from luma_cli.core.output import ASPECT_RATIOS, console, print_models
+
+
+@click.command()
+def models() -> None:
+    """List available Luma models."""
+    print_models()
+
+
+@click.command("aspect-ratios")
+def aspect_ratios() -> None:
+    """List available aspect ratios."""
+    from rich.table import Table
+
+    table = Table(title="Available Aspect Ratios")
+    table.add_column("Ratio", style="bold cyan")
+    table.add_column("Orientation")
+
+    for ratio in ASPECT_RATIOS:
+        w, h = ratio.split(":")
+        if int(w) > int(h):
+            orientation = "Landscape"
+        elif int(w) < int(h):
+            orientation = "Portrait"
+        else:
+            orientation = "Square"
+        table.add_row(ratio, orientation)
+
+    console.print(table)
+
+
+@click.command()
+def config() -> None:
+    """Show current configuration."""
+    from rich.table import Table
+
+    table = Table(title="Luma CLI Configuration")
+    table.add_column("Setting", style="bold cyan")
+    table.add_column("Value")
+
+    table.add_row("API Base URL", settings.api_base_url)
+    table.add_row(
+        "API Token", f"{settings.api_token[:8]}..." if settings.api_token else "[red]Not set[/red]"
+    )
+    table.add_row("Default Model", settings.default_model)
+    table.add_row("Request Timeout", f"{settings.request_timeout}s")
+
+    console.print(table)