acedatacloud-cli 2026.4.5.0__tar.gz

acedatacloud_cli-2026.4.5.0/.env.example

@@ -0,0 +1,9 @@
+# AceDataCloud API Token (required)
+# Get your token at https://platform.acedata.cloud
+ACEDATACLOUD_API_TOKEN=
+
+# API Base URL (optional, defaults to https://api.acedata.cloud)
+# ACEDATACLOUD_API_BASE_URL=https://api.acedata.cloud
+
+# Request timeout in seconds (optional, defaults to 1800)
+# ADC_REQUEST_TIMEOUT=1800

acedatacloud_cli-2026.4.5.0/CHANGELOG.md

@@ -0,0 +1,18 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [0.1.0] - 2025-01-21
+
+### Added
+- Initial release of AceDataCloud unified CLI
+- `adc image` — Generate images via Flux, Midjourney, Seedream, NanoBanana
+- `adc video` — Generate videos via Luma, Sora, Veo, Seedance
+- `adc music` — Generate music via Suno
+- `adc search` — Google search via SERP API
+- `adc task` / `adc wait` — Task status polling for all services
+- `adc auth login` / `adc auth status` — Token management
+- `adc services` — List all available services
+- `adc config` — Show current configuration
+- `--json` flag on all commands for machine-readable output
+- Config file persistence at `~/.config/adc/config`

acedatacloud_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.

acedatacloud_cli-2026.4.5.0/PKG-INFO

@@ -0,0 +1,192 @@
+Metadata-Version: 2.1
+Name: acedatacloud-cli
+Version: 2026.4.5.0
+Summary: Unified CLI for AceDataCloud AI services - images, videos, music, search, and chat
+Project-URL: Homepage, https://github.com/AceDataCloud/AdcCli
+Project-URL: Repository, https://github.com/AceDataCloud/AdcCli
+Project-URL: Issues, https://github.com/AceDataCloud/AdcCli/issues
+Project-URL: Changelog, https://github.com/AceDataCloud/AdcCli/blob/main/CHANGELOG.md
+Author-email: AceDataCloud <support@acedata.cloud>
+Maintainer-email: AceDataCloud <support@acedata.cloud>
+License: MIT
+License-File: LICENSE
+Keywords: acedata,ai,chat,cli,command-line,image-generation,music-generation,search,video-generation
+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
+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: acedatacloud-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
+
+# AceDataCloud CLI
+
+Unified command-line interface for all AceDataCloud AI services — images, videos, music, and search.
+
+## Installation
+
+```bash
+pip install acedatacloud-cli
+```
+
+## Quick Start
+
+```bash
+# Save your API token
+adc auth login
+
+# Generate an image
+adc image "A sunset over mountains, photorealistic"
+
+# Generate a video
+adc video "A cinematic ocean scene"
+
+# Generate music
+adc music "Upbeat electronic dance track"
+
+# Search the web
+adc search "artificial intelligence"
+
+# Check task status
+adc task abc123 -s flux
+
+# Wait for completion
+adc wait abc123 -s flux
+```
+
+## Configuration
+
+Get your API token at [platform.acedata.cloud](https://platform.acedata.cloud).
+
+```bash
+# Option 1: Login command (saves to ~/.config/adc/config)
+adc auth login
+
+# Option 2: Environment variable
+export ACEDATACLOUD_API_TOKEN=your_token
+
+# Option 3: Per-command flag
+adc --token your_token image "A sunset"
+```
+
+## Commands
+
+### Image Generation
+
+```bash
+adc image "A sunset over mountains"                        # Flux (default)
+adc image "Cyberpunk city" --service midjourney             # Midjourney
+adc image "Logo design" --service seedream                  # Seedream
+adc image "Add sunglasses" --image-url https://...         # Edit with Flux
+adc image "A landscape" -m flux-pro-1.1-ultra -s 16:9     # Custom model & size
+```
+
+### Video Generation
+
+```bash
+adc video "A cinematic sunset"                              # Luma (default)
+adc video "A rocket launching" --service sora               # Sora
+adc video "Clouds moving" --service veo                     # Veo
+adc video "Dance scene" --service seedance                  # Seedance
+adc video "Cat playing" --loop -a 16:9                      # Loop + aspect ratio
+```
+
+### Music Generation
+
+```bash
+adc music "An upbeat electronic dance track"
+adc music "Calm piano jazz" --instrumental
+```
+
+### Web Search
+
+```bash
+adc search "artificial intelligence"
+adc search "tech news" -t news --time-range qdr:d
+adc search "sunset photos" -t images -c us
+```
+
+### Task Management
+
+```bash
+adc task abc123 -s flux          # Check task status
+adc task def456 -s luma --json   # JSON output
+adc wait abc123 -s flux          # Wait for completion
+adc wait def456 -s suno --interval 10 --timeout 300
+```
+
+### Info & Auth
+
+```bash
+adc services                     # List all available services
+adc config                       # Show configuration
+adc auth login                   # Save API token
+adc auth status                  # Check auth status
+```
+
+## JSON Output
+
+All commands support `--json` for machine-readable output:
+
+```bash
+adc image "A sunset" --json | jq '.task_id'
+adc search "test query" --json | jq '.organic[].title'
+```
+
+## Supported Services
+
+| Service      | Type   | Command                    |
+| ------------ | ------ | -------------------------- |
+| Flux         | Image  | `adc image --service flux` |
+| Midjourney   | Image  | `adc image --service midjourney` |
+| Seedream     | Image  | `adc image --service seedream` |
+| NanoBanana   | Image  | `adc image --service nanobanana` |
+| Suno         | Music  | `adc music`                |
+| Luma         | Video  | `adc video --service luma` |
+| Sora         | Video  | `adc video --service sora` |
+| Veo          | Video  | `adc video --service veo`  |
+| Seedance     | Video  | `adc video --service seedance` |
+| SERP         | Search | `adc search`               |
+
+## Development
+
+```bash
+# Install with dev dependencies
+pip install -e ".[all]"
+
+# Run tests
+pytest
+
+# Lint
+ruff check .
+ruff format --check .
+```
+
+## License
+
+MIT

acedatacloud_cli-2026.4.5.0/README.md

@@ -0,0 +1,146 @@
+# AceDataCloud CLI
+
+Unified command-line interface for all AceDataCloud AI services — images, videos, music, and search.
+
+## Installation
+
+```bash
+pip install acedatacloud-cli
+```
+
+## Quick Start
+
+```bash
+# Save your API token
+adc auth login
+
+# Generate an image
+adc image "A sunset over mountains, photorealistic"
+
+# Generate a video
+adc video "A cinematic ocean scene"
+
+# Generate music
+adc music "Upbeat electronic dance track"
+
+# Search the web
+adc search "artificial intelligence"
+
+# Check task status
+adc task abc123 -s flux
+
+# Wait for completion
+adc wait abc123 -s flux
+```
+
+## Configuration
+
+Get your API token at [platform.acedata.cloud](https://platform.acedata.cloud).
+
+```bash
+# Option 1: Login command (saves to ~/.config/adc/config)
+adc auth login
+
+# Option 2: Environment variable
+export ACEDATACLOUD_API_TOKEN=your_token
+
+# Option 3: Per-command flag
+adc --token your_token image "A sunset"
+```
+
+## Commands
+
+### Image Generation
+
+```bash
+adc image "A sunset over mountains"                        # Flux (default)
+adc image "Cyberpunk city" --service midjourney             # Midjourney
+adc image "Logo design" --service seedream                  # Seedream
+adc image "Add sunglasses" --image-url https://...         # Edit with Flux
+adc image "A landscape" -m flux-pro-1.1-ultra -s 16:9     # Custom model & size
+```
+
+### Video Generation
+
+```bash
+adc video "A cinematic sunset"                              # Luma (default)
+adc video "A rocket launching" --service sora               # Sora
+adc video "Clouds moving" --service veo                     # Veo
+adc video "Dance scene" --service seedance                  # Seedance
+adc video "Cat playing" --loop -a 16:9                      # Loop + aspect ratio
+```
+
+### Music Generation
+
+```bash
+adc music "An upbeat electronic dance track"
+adc music "Calm piano jazz" --instrumental
+```
+
+### Web Search
+
+```bash
+adc search "artificial intelligence"
+adc search "tech news" -t news --time-range qdr:d
+adc search "sunset photos" -t images -c us
+```
+
+### Task Management
+
+```bash
+adc task abc123 -s flux          # Check task status
+adc task def456 -s luma --json   # JSON output
+adc wait abc123 -s flux          # Wait for completion
+adc wait def456 -s suno --interval 10 --timeout 300
+```
+
+### Info & Auth
+
+```bash
+adc services                     # List all available services
+adc config                       # Show configuration
+adc auth login                   # Save API token
+adc auth status                  # Check auth status
+```
+
+## JSON Output
+
+All commands support `--json` for machine-readable output:
+
+```bash
+adc image "A sunset" --json | jq '.task_id'
+adc search "test query" --json | jq '.organic[].title'
+```
+
+## Supported Services
+
+| Service      | Type   | Command                    |
+| ------------ | ------ | -------------------------- |
+| Flux         | Image  | `adc image --service flux` |
+| Midjourney   | Image  | `adc image --service midjourney` |
+| Seedream     | Image  | `adc image --service seedream` |
+| NanoBanana   | Image  | `adc image --service nanobanana` |
+| Suno         | Music  | `adc music`                |
+| Luma         | Video  | `adc video --service luma` |
+| Sora         | Video  | `adc video --service sora` |
+| Veo          | Video  | `adc video --service veo`  |
+| Seedance     | Video  | `adc video --service seedance` |
+| SERP         | Search | `adc search`               |
+
+## Development
+
+```bash
+# Install with dev dependencies
+pip install -e ".[all]"
+
+# Run tests
+pytest
+
+# Lint
+ruff check .
+ruff format --check .
+```
+
+## License
+
+MIT

acedatacloud_cli-2026.4.5.0/adc_cli/__init__.py

@@ -0,0 +1 @@
+"""AceDataCloud CLI - Unified CLI for AI services."""

acedatacloud_cli-2026.4.5.0/adc_cli/__main__.py

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

acedatacloud_cli-2026.4.5.0/adc_cli/commands/auth.py

@@ -0,0 +1,55 @@
+"""Auth commands for token management."""
+
+import click
+
+from adc_cli.core.config import save_token_to_config, settings
+from adc_cli.core.output import console, print_success
+
+
+@click.group()
+def auth() -> None:
+    """Manage API authentication.
+
+    \b
+    Examples:
+      adc auth login
+      adc auth status
+    """
+
+
+@auth.command()
+@click.option("--token", prompt="API Token", hide_input=True, help="Your AceDataCloud API token.")
+def login(token: str) -> None:
+    """Save your API token for future use.
+
+    Get your token at https://platform.acedata.cloud
+
+    Examples:
+
+      adc auth login
+    """
+    save_token_to_config(token)
+    print_success("Token saved successfully!")
+    console.print("[dim]Token stored in ~/.config/adc/config[/dim]")
+
+
+@auth.command()
+def status() -> None:
+    """Check current authentication status."""
+    from rich.table import Table
+
+    table = Table(title="Auth Status")
+    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 configured[/red]",
+    )
+    table.add_row(
+        "Status",
+        "[green]Configured[/green]" if settings.is_configured else "[red]Not configured[/red]",
+    )
+
+    console.print(table)

acedatacloud_cli-2026.4.5.0/adc_cli/commands/image.py

@@ -0,0 +1,84 @@
+"""Image generation commands."""
+
+import click
+
+from adc_cli.core.client import get_client
+from adc_cli.core.exceptions import AdcError
+from adc_cli.core.output import print_error, print_json, print_result
+
+
+@click.command()
+@click.argument("prompt")
+@click.option(
+    "--service",
+    type=click.Choice(["flux", "midjourney", "seedream", "nanobanana"]),
+    default="flux",
+    help="Image generation service to use.",
+)
+@click.option("-m", "--model", default=None, help="Model name (service-specific).")
+@click.option("-s", "--size", default=None, help="Image size or aspect ratio.")
+@click.option("-n", "--count", default=None, type=int, help="Number of images.")
+@click.option("--image-url", default=None, help="Source image URL (for editing).")
+@click.option("--json", "output_json", is_flag=True, help="Output raw JSON.")
+@click.pass_context
+def image(
+    ctx: click.Context,
+    prompt: str,
+    service: str,
+    model: str | None,
+    size: str | None,
+    count: int | None,
+    image_url: str | None,
+    output_json: bool,
+) -> None:
+    """Generate or edit an image using AI.
+
+    PROMPT describes the image to generate or changes to make.
+
+    \b
+    Examples:
+      adc image "A sunset over mountains, photorealistic"
+      adc image "Cyberpunk city" --service midjourney
+      adc image "Add sunglasses" --image-url https://example.com/photo.jpg
+      adc image "Logo design" --service flux -m flux-pro-1.1-ultra -s 16:9
+    """
+    client = get_client(ctx.obj.get("token"))
+    try:
+        if service == "flux":
+            action = "edit" if image_url else "generate"
+            payload: dict[str, object] = {
+                "action": action,
+                "prompt": prompt,
+                "model": model or ("flux-kontext-pro" if image_url else "flux-dev"),
+                "size": size,
+                "count": count,
+                "image_url": image_url,
+            }
+            result = client.flux_image(**payload)  # type: ignore[arg-type]
+        elif service == "midjourney":
+            payload = {
+                "prompt": prompt,
+                "size": size,
+                "version": model,
+            }
+            result = client.midjourney_imagine(**payload)  # type: ignore[arg-type]
+        else:
+            # seedream, nanobanana — generic image endpoint
+            payload = {
+                "action": "generate",
+                "prompt": prompt,
+                "model": model,
+                "size": size,
+            }
+            result = client.request(
+                f"/{service}/images",
+                client._with_async_callback(payload),  # noqa: SLF001
+            )
+
+        if output_json:
+            print_json(result)
+        else:
+            print_result(result, "Image Result")
+    except AdcError as e:
+        print_error(e.message)
+        raise SystemExit(1) from e

acedatacloud_cli-2026.4.5.0/adc_cli/commands/info.py

@@ -0,0 +1,31 @@
+"""Info and utility commands."""
+
+import click
+
+from adc_cli.core.config import settings
+from adc_cli.core.output import console, print_services
+
+
+@click.command()
+def services() -> None:
+    """List all available AceDataCloud services."""
+    print_services()
+
+
+@click.command()
+def config() -> None:
+    """Show current configuration."""
+    from rich.table import Table
+
+    table = Table(title="AceDataCloud 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)

acedatacloud_cli-2026.4.5.0/adc_cli/commands/music.py

@@ -0,0 +1,45 @@
+"""Music generation commands."""
+
+import click
+
+from adc_cli.core.client import get_client
+from adc_cli.core.exceptions import AdcError
+from adc_cli.core.output import print_error, print_json, print_result
+
+
+@click.command()
+@click.argument("prompt")
+@click.option("--instrumental", is_flag=True, default=False, help="Generate instrumental only.")
+@click.option("--json", "output_json", is_flag=True, help="Output raw JSON.")
+@click.pass_context
+def music(
+    ctx: click.Context,
+    prompt: str,
+    instrumental: bool,
+    output_json: bool,
+) -> None:
+    """Generate music using Suno AI.
+
+    PROMPT describes the music to generate.
+
+    \b
+    Examples:
+      adc music "An upbeat electronic dance track"
+      adc music "Calm piano jazz" --instrumental
+    """
+    client = get_client(ctx.obj.get("token"))
+    try:
+        payload: dict[str, object] = {
+            "action": "generate",
+            "prompt": prompt,
+            "instrumental": instrumental,
+        }
+
+        result = client.suno_music(**payload)  # type: ignore[arg-type]
+        if output_json:
+            print_json(result)
+        else:
+            print_result(result, "Music Result")
+    except AdcError as e:
+        print_error(e.message)
+        raise SystemExit(1) from e

acedatacloud_cli-2026.4.5.0/adc_cli/commands/search.py

@@ -0,0 +1,64 @@
+"""Search commands."""
+
+import click
+
+from adc_cli.core.client import get_client
+from adc_cli.core.exceptions import AdcError
+from adc_cli.core.output import print_error, print_json, print_search_result
+
+
+@click.command()
+@click.argument("query")
+@click.option(
+    "-t",
+    "--type",
+    "search_type",
+    type=click.Choice(["search", "images", "news", "maps", "places", "videos"]),
+    default="search",
+    help="Type of search.",
+)
+@click.option("-c", "--country", default=None, help="Country code (e.g. us, cn, uk).")
+@click.option("-l", "--language", default=None, help="Language code (e.g. en, zh-cn).")
+@click.option("--time-range", default=None, help="Time filter: qdr:h, qdr:d, qdr:w, qdr:m.")
+@click.option("-n", "--number", default=None, type=int, help="Number of results.")
+@click.option("--json", "output_json", is_flag=True, help="Output raw JSON.")
+@click.pass_context
+def search(
+    ctx: click.Context,
+    query: str,
+    search_type: str,
+    country: str | None,
+    language: str | None,
+    time_range: str | None,
+    number: int | None,
+    output_json: bool,
+) -> None:
+    """Search Google using SERP API.
+
+    QUERY is the search query.
+
+    \b
+    Examples:
+      adc search "artificial intelligence"
+      adc search "tech news" -t news --time-range qdr:d
+      adc search "sunset photos" -t images -c us
+    """
+    client = get_client(ctx.obj.get("token"))
+    try:
+        payload: dict[str, object] = {
+            "query": query,
+            "type": search_type,
+            "country": country,
+            "language": language,
+            "range": time_range,
+            "number": number,
+        }
+
+        result = client.serp_search(**payload)  # type: ignore[arg-type]
+        if output_json:
+            print_json(result)
+        else:
+            print_search_result(result)
+    except AdcError as e:
+        print_error(e.message)
+        raise SystemExit(1) from e