flux-pro-cli 2026.4.5.0__tar.gz

flux_pro_cli-2026.4.5.0/.env.example

@@ -0,0 +1,9 @@
+# AceDataCloud API Token
+# Get yours at https://platform.acedata.cloud
+ACEDATACLOUD_API_TOKEN=
+
+# Optional: Custom API base URL (default: https://api.acedata.cloud)
+# ACEDATACLOUD_API_BASE_URL=https://api.acedata.cloud
+
+# Optional: Request timeout in seconds (default: 1800)
+# FLUX_REQUEST_TIMEOUT=1800

flux_pro_cli-2026.4.5.0/CHANGELOG.md

@@ -0,0 +1,22 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [0.1.0] - 2025-01-21
+
+### Added
+
+- Initial release of Flux CLI
+- `generate` command for text-to-image generation
+- `edit` command for image editing with text prompts
+- `task` command for querying task status
+- `tasks` command for batch task queries
+- `wait` command for polling task completion
+- `models` command to list available Flux models
+- `aspect-ratios` command to list available aspect ratios
+- `config` command to show current configuration
+- Support for all Flux models: flux-dev, flux-pro, flux-pro-1.1, flux-pro-1.1-ultra, flux-kontext-pro, flux-kontext-max
+- `--json` flag for machine-readable output on all commands
+- `--token` option and `ACEDATACLOUD_API_TOKEN` env var for authentication
+- Rich terminal formatting for human-readable output
+- Docker support via Dockerfile and docker-compose.yaml

flux_pro_cli-2026.4.5.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 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.

flux_pro_cli-2026.4.5.0/PKG-INFO

@@ -0,0 +1,167 @@
+Metadata-Version: 2.1
+Name: flux-pro-cli
+Version: 2026.4.5.0
+Summary: CLI tool for Flux AI Image Generation via AceDataCloud API
+Project-URL: Homepage, https://github.com/AceDataCloud/FluxCli
+Project-URL: Repository, https://github.com/AceDataCloud/FluxCli
+Project-URL: Issues, https://github.com/AceDataCloud/FluxCli/issues
+Project-URL: Changelog, https://github.com/AceDataCloud/FluxCli/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,flux,generation,image
+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 :: Graphics
+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: flux-pro-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
+
+# Flux CLI
+
+A command-line tool for AI image generation and editing using [Flux](https://blackforestlabs.ai/) through the [AceDataCloud](https://platform.acedata.cloud) platform.
+
+## Features
+
+- **Text-to-Image Generation** — Generate images from text prompts with multiple Flux models
+- **Image Editing** — Edit existing images using text descriptions (kontext models)
+- **Task Management** — Query status, batch check, and poll for completion
+- **Multiple Models** — flux-dev, flux-pro, flux-pro-1.1, flux-pro-1.1-ultra, flux-kontext-pro, flux-kontext-max
+- **Rich Output** — Beautiful terminal formatting with `--json` for scripting
+
+## Installation
+
+```bash
+pip install flux-pro-cli
+```
+
+## Quick Start
+
+```bash
+# Set your API token
+export ACEDATACLOUD_API_TOKEN=your_token_here
+
+# Generate an image
+flux generate "A majestic mountain landscape at golden hour, photorealistic"
+
+# Generate with a specific model
+flux generate "Cyberpunk city with neon lights" -m flux-pro-1.1
+
+# Generate with aspect ratio (ultra/kontext models)
+flux generate "Minimalist logo of a phoenix" -m flux-pro-1.1-ultra -s 16:9
+
+# Edit an existing image
+flux edit "Add sunglasses to the person" --image-url https://example.com/photo.jpg
+
+# Edit with max context model
+flux edit "Change background to sunset beach" --image-url https://example.com/img.png -m flux-kontext-max
+
+# Check task status
+flux task abc123-def456
+
+# Wait for task completion
+flux wait abc123 --interval 5 --timeout 300
+
+# Batch check multiple tasks
+flux tasks task-1 task-2 task-3
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `generate` | Generate an image from a text prompt |
+| `edit` | Edit an existing image with a text prompt |
+| `task` | Query a single task status |
+| `tasks` | Query multiple tasks at once |
+| `wait` | Wait for a task to complete |
+| `models` | List available Flux models |
+| `aspect-ratios` | List available aspect ratios |
+| `config` | Show current configuration |
+
+## Models
+
+| Model | Type | Size Input | Notes |
+|-------|------|-----------|-------|
+| `flux-dev` | Dev | Pixels | Fast, good balance (default) |
+| `flux-pro` | Pro | Pixels | Higher quality |
+| `flux-pro-1.1` | Pro | Pixels | Better prompt following |
+| `flux-pro-1.1-ultra` | Ultra | Aspect ratio | Highest quality |
+| `flux-kontext-pro` | Kontext | Aspect ratio | Best for editing/style transfer |
+| `flux-kontext-max` | Kontext | Aspect ratio | Max context for complex edits |
+
+## JSON Output
+
+All commands support `--json` for machine-readable output:
+
+```bash
+flux generate "A red car" --json | jq '.task_id'
+flux task abc123 --json | jq '.data[0].image_url'
+```
+
+## Configuration
+
+| Environment Variable | Description | Default |
+|---------------------|-------------|---------|
+| `ACEDATACLOUD_API_TOKEN` | API authentication token | (required) |
+| `ACEDATACLOUD_API_BASE_URL` | API base URL | `https://api.acedata.cloud` |
+| `FLUX_REQUEST_TIMEOUT` | Request timeout in seconds | `1800` |
+
+You can also use a `.env` file or pass `--token` directly.
+
+## Docker
+
+```bash
+docker compose run flux-cli generate "A beautiful sunset"
+```
+
+## Development
+
+```bash
+# Install with dev dependencies
+pip install -e ".[all]"
+
+# Run tests
+pytest
+
+# Run linter
+ruff check .
+ruff format --check .
+```
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+## Links
+
+- [AceDataCloud Platform](https://platform.acedata.cloud)
+- [API Documentation](https://docs.acedata.cloud)
+- [Flux by Black Forest Labs](https://blackforestlabs.ai/)

flux_pro_cli-2026.4.5.0/README.md

@@ -0,0 +1,121 @@
+# Flux CLI
+
+A command-line tool for AI image generation and editing using [Flux](https://blackforestlabs.ai/) through the [AceDataCloud](https://platform.acedata.cloud) platform.
+
+## Features
+
+- **Text-to-Image Generation** — Generate images from text prompts with multiple Flux models
+- **Image Editing** — Edit existing images using text descriptions (kontext models)
+- **Task Management** — Query status, batch check, and poll for completion
+- **Multiple Models** — flux-dev, flux-pro, flux-pro-1.1, flux-pro-1.1-ultra, flux-kontext-pro, flux-kontext-max
+- **Rich Output** — Beautiful terminal formatting with `--json` for scripting
+
+## Installation
+
+```bash
+pip install flux-pro-cli
+```
+
+## Quick Start
+
+```bash
+# Set your API token
+export ACEDATACLOUD_API_TOKEN=your_token_here
+
+# Generate an image
+flux generate "A majestic mountain landscape at golden hour, photorealistic"
+
+# Generate with a specific model
+flux generate "Cyberpunk city with neon lights" -m flux-pro-1.1
+
+# Generate with aspect ratio (ultra/kontext models)
+flux generate "Minimalist logo of a phoenix" -m flux-pro-1.1-ultra -s 16:9
+
+# Edit an existing image
+flux edit "Add sunglasses to the person" --image-url https://example.com/photo.jpg
+
+# Edit with max context model
+flux edit "Change background to sunset beach" --image-url https://example.com/img.png -m flux-kontext-max
+
+# Check task status
+flux task abc123-def456
+
+# Wait for task completion
+flux wait abc123 --interval 5 --timeout 300
+
+# Batch check multiple tasks
+flux tasks task-1 task-2 task-3
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `generate` | Generate an image from a text prompt |
+| `edit` | Edit an existing image with a text prompt |
+| `task` | Query a single task status |
+| `tasks` | Query multiple tasks at once |
+| `wait` | Wait for a task to complete |
+| `models` | List available Flux models |
+| `aspect-ratios` | List available aspect ratios |
+| `config` | Show current configuration |
+
+## Models
+
+| Model | Type | Size Input | Notes |
+|-------|------|-----------|-------|
+| `flux-dev` | Dev | Pixels | Fast, good balance (default) |
+| `flux-pro` | Pro | Pixels | Higher quality |
+| `flux-pro-1.1` | Pro | Pixels | Better prompt following |
+| `flux-pro-1.1-ultra` | Ultra | Aspect ratio | Highest quality |
+| `flux-kontext-pro` | Kontext | Aspect ratio | Best for editing/style transfer |
+| `flux-kontext-max` | Kontext | Aspect ratio | Max context for complex edits |
+
+## JSON Output
+
+All commands support `--json` for machine-readable output:
+
+```bash
+flux generate "A red car" --json | jq '.task_id'
+flux task abc123 --json | jq '.data[0].image_url'
+```
+
+## Configuration
+
+| Environment Variable | Description | Default |
+|---------------------|-------------|---------|
+| `ACEDATACLOUD_API_TOKEN` | API authentication token | (required) |
+| `ACEDATACLOUD_API_BASE_URL` | API base URL | `https://api.acedata.cloud` |
+| `FLUX_REQUEST_TIMEOUT` | Request timeout in seconds | `1800` |
+
+You can also use a `.env` file or pass `--token` directly.
+
+## Docker
+
+```bash
+docker compose run flux-cli generate "A beautiful sunset"
+```
+
+## Development
+
+```bash
+# Install with dev dependencies
+pip install -e ".[all]"
+
+# Run tests
+pytest
+
+# Run linter
+ruff check .
+ruff format --check .
+```
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+## Links
+
+- [AceDataCloud Platform](https://platform.acedata.cloud)
+- [API Documentation](https://docs.acedata.cloud)
+- [Flux by Black Forest Labs](https://blackforestlabs.ai/)

flux_pro_cli-2026.4.5.0/flux_cli/__init__.py

@@ -0,0 +1 @@
+"""Flux CLI - AI Image Generation via AceDataCloud API."""

flux_pro_cli-2026.4.5.0/flux_cli/__main__.py

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

flux_pro_cli-2026.4.5.0/flux_cli/commands/image.py

@@ -0,0 +1,165 @@
+"""Image generation and editing commands."""
+
+import click
+
+from flux_cli.core.client import get_client
+from flux_cli.core.exceptions import FluxError
+from flux_cli.core.output import (
+    ASPECT_RATIOS,
+    DEFAULT_MODEL,
+    FLUX_MODELS,
+    print_error,
+    print_image_result,
+    print_json,
+)
+
+
+@click.command()
+@click.argument("prompt")
+@click.option(
+    "-m",
+    "--model",
+    type=click.Choice(FLUX_MODELS),
+    default=DEFAULT_MODEL,
+    help="Flux model to use.",
+)
+@click.option(
+    "-s",
+    "--size",
+    default=None,
+    help="Image size: pixels (e.g. 1024x1024) or aspect ratio (e.g. 16:9).",
+)
+@click.option(
+    "-n",
+    "--count",
+    default=None,
+    type=int,
+    help="Number of images to generate.",
+)
+@click.option("--callback-url", default=None, help="Webhook callback URL.")
+@click.option("--json", "output_json", is_flag=True, help="Output raw JSON.")
+@click.pass_context
+def generate(
+    ctx: click.Context,
+    prompt: str,
+    model: str,
+    size: str | None,
+    count: int | None,
+    callback_url: str | None,
+    output_json: bool,
+) -> None:
+    """Generate an image from a text prompt.
+
+    PROMPT is a detailed description of the image to generate.
+
+    \b
+    Examples:
+      flux generate "A majestic mountain at golden hour, photorealistic"
+      flux generate "Cyberpunk city with neon lights" -m flux-pro-1.1
+      flux generate "Minimalist logo of a phoenix" -m flux-pro-1.1-ultra -s 16:9
+    """
+    client = get_client(ctx.obj.get("token"))
+    try:
+        payload: dict[str, object] = {
+            "action": "generate",
+            "prompt": prompt,
+            "model": model,
+            "size": size,
+            "count": count,
+            "callback_url": callback_url,
+        }
+
+        result = client.generate_image(**payload)  # type: ignore[arg-type]
+        if output_json:
+            print_json(result)
+        else:
+            print_image_result(result)
+    except FluxError as e:
+        print_error(e.message)
+        raise SystemExit(1) from e
+
+
+@click.command()
+@click.argument("prompt")
+@click.option(
+    "--image-url",
+    required=True,
+    help="URL of the image to edit.",
+)
+@click.option(
+    "-m",
+    "--model",
+    type=click.Choice(FLUX_MODELS),
+    default="flux-kontext-pro",
+    help="Flux model to use (default: flux-kontext-pro).",
+)
+@click.option(
+    "-s",
+    "--size",
+    default=None,
+    help="Output size: pixels or aspect ratio.",
+)
+@click.option("--callback-url", default=None, help="Webhook callback URL.")
+@click.option("--json", "output_json", is_flag=True, help="Output raw JSON.")
+@click.pass_context
+def edit(
+    ctx: click.Context,
+    prompt: str,
+    image_url: str,
+    model: str,
+    size: str | None,
+    callback_url: str | None,
+    output_json: bool,
+) -> None:
+    """Edit an existing image with a text prompt.
+
+    PROMPT describes the desired changes to the image.
+
+    \b
+    Examples:
+      flux edit "Add sunglasses" --image-url https://example.com/photo.jpg
+      flux edit "Change background to sunset" --image-url https://example.com/img.png -m flux-kontext-max
+    """
+    client = get_client(ctx.obj.get("token"))
+    try:
+        payload: dict[str, object] = {
+            "action": "edit",
+            "prompt": prompt,
+            "image_url": image_url,
+            "model": model,
+            "size": size,
+            "callback_url": callback_url,
+        }
+
+        result = client.edit_image(**payload)  # type: ignore[arg-type]
+        if output_json:
+            print_json(result)
+        else:
+            print_image_result(result)
+    except FluxError as e:
+        print_error(e.message)
+        raise SystemExit(1) from e
+
+
+@click.command("aspect-ratios")
+def aspect_ratios() -> None:
+    """List available aspect ratios for ultra/kontext models."""
+    from rich.table import Table
+
+    from flux_cli.core.output import console
+
+    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)

flux_pro_cli-2026.4.5.0/flux_cli/commands/info.py

@@ -0,0 +1,31 @@
+"""Info and utility commands."""
+
+import click
+
+from flux_cli.core.config import settings
+from flux_cli.core.output import console, print_models
+
+
+@click.command()
+def models() -> None:
+    """List available Flux models."""
+    print_models()
+
+
+@click.command()
+def config() -> None:
+    """Show current configuration."""
+    from rich.table import Table
+
+    table = Table(title="Flux 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("Request Timeout", f"{settings.request_timeout}s")
+
+    console.print(table)

flux_pro_cli-2026.4.5.0/flux_cli/commands/task.py

@@ -0,0 +1,141 @@
+"""Task management commands."""
+
+import time
+
+import click
+
+from flux_cli.core.client import get_client
+from flux_cli.core.exceptions import FluxError
+from flux_cli.core.output import print_error, print_json, print_success, print_task_result
+
+
+@click.command()
+@click.argument("task_id")
+@click.option("--json", "output_json", is_flag=True, help="Output raw JSON.")
+@click.pass_context
+def task(
+    ctx: click.Context,
+    task_id: str,
+    output_json: bool,
+) -> None:
+    """Query a single task status.
+
+    TASK_ID is the task ID returned from generate/edit commands.
+
+    Examples:
+
+      flux task abc123-def456
+    """
+    client = get_client(ctx.obj.get("token"))
+    try:
+        result = client.query_task(id=task_id, action="retrieve")
+        if output_json:
+            print_json(result)
+        else:
+            print_task_result(result)
+    except FluxError as e:
+        print_error(e.message)
+        raise SystemExit(1) from e
+
+
+@click.command("tasks")
+@click.argument("task_ids", nargs=-1, required=True)
+@click.option("--json", "output_json", is_flag=True, help="Output raw JSON.")
+@click.pass_context
+def tasks_batch(
+    ctx: click.Context,
+    task_ids: tuple[str, ...],
+    output_json: bool,
+) -> None:
+    """Query multiple tasks at once.
+
+    TASK_IDS are space-separated task IDs.
+
+    Examples:
+
+      flux tasks abc123 def456 ghi789
+    """
+    client = get_client(ctx.obj.get("token"))
+    try:
+        result = client.query_task(ids=list(task_ids), action="retrieve_batch")
+        if output_json:
+            print_json(result)
+        else:
+            print_task_result(result)
+    except FluxError as e:
+        print_error(e.message)
+        raise SystemExit(1) from e
+
+
+@click.command()
+@click.argument("task_id")
+@click.option(
+    "--interval",
+    type=int,
+    default=5,
+    help="Polling interval in seconds (default: 5).",
+)
+@click.option(
+    "--timeout",
+    "max_timeout",
+    type=int,
+    default=600,
+    help="Maximum wait time in seconds (default: 600).",
+)
+@click.option("--json", "output_json", is_flag=True, help="Output raw JSON.")
+@click.pass_context
+def wait(
+    ctx: click.Context,
+    task_id: str,
+    interval: int,
+    max_timeout: int,
+    output_json: bool,
+) -> None:
+    """Wait for a task to complete, polling periodically.
+
+    TASK_ID is the task ID to monitor.
+
+    Examples:
+
+      flux wait abc123
+
+      flux wait abc123 --interval 10 --timeout 300
+    """
+    client = get_client(ctx.obj.get("token"))
+    elapsed = 0
+
+    try:
+        while elapsed < max_timeout:
+            result = client.query_task(id=task_id, action="retrieve")
+            data = result.get("data", {})
+
+            if isinstance(data, list) and data:
+                item = data[0]
+            elif isinstance(data, dict):
+                item = data
+            else:
+                item = {}
+
+            state = item.get("state", item.get("status", ""))
+            if state in ("succeeded", "completed", "complete", "failed", "error"):
+                if output_json:
+                    print_json(result)
+                else:
+                    if state in ("failed", "error"):
+                        print_error(f"Task {task_id} failed.")
+                    else:
+                        print_success(f"Task {task_id} completed!")
+                    print_task_result(result)
+                return
+
+            if not output_json:
+                click.echo(f"Status: {state or 'pending'} (waited {elapsed}s)...", err=True)
+
+            time.sleep(interval)
+            elapsed += interval
+
+        print_error(f"Timeout: task {task_id} did not complete within {max_timeout}s")
+        raise SystemExit(1)
+    except FluxError as e:
+        print_error(e.message)
+        raise SystemExit(1) from e