seedream-cli 2026.3.17.0__tar.gz

seedream_cli-2026.3.17.0/.env.example

@@ -0,0 +1,5 @@
+# Seedream CLI Environment
+ACEDATACLOUD_API_TOKEN=your_api_token_here
+# ACEDATACLOUD_API_BASE_URL=https://api.acedata.cloud
+# SEEDREAM_DEFAULT_MODEL=doubao-seedream-4-0-250828
+# SEEDREAM_REQUEST_TIMEOUT=1800

seedream_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/

seedream_cli-2026.3.17.0/CHANGELOG.md

@@ -0,0 +1,17 @@
+# 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
+- Seedream image generation from text prompts
+- Image editing capabilities
+- Task management with polling
+- Rich terminal output with tables and panels
+- JSON output mode (`--json` flag)
+- Multiple model support

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

seedream_cli-2026.3.17.0/PKG-INFO

@@ -0,0 +1,266 @@
+Metadata-Version: 2.1
+Name: seedream-cli
+Version: 2026.3.17.0
+Summary: CLI tool for Seedream AI Image Generation via AceDataCloud API
+Project-URL: Homepage, https://github.com/AceDataCloud/SeedreamCli
+Project-URL: Repository, https://github.com/AceDataCloud/SeedreamCli
+Project-URL: Issues, https://github.com/AceDataCloud/SeedreamCli/issues
+Project-URL: Changelog, https://github.com/AceDataCloud/SeedreamCli/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,image,seedream
+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: seedream-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
+
+# Seedream CLI
+
+[![PyPI version](https://img.shields.io/pypi/v/seedream-cli.svg)](https://pypi.org/project/seedream-cli/)
+[![PyPI downloads](https://img.shields.io/pypi/dm/seedream-cli.svg)](https://pypi.org/project/seedream-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/SeedreamCli/actions/workflows/ci.yaml/badge.svg)](https://github.com/AceDataCloud/SeedreamCli/actions/workflows/ci.yaml)
+
+A command-line tool for AI image generation using [Seedream](https://platform.acedata.cloud/) through the [AceDataCloud API](https://platform.acedata.cloud/).
+
+Generate AI images directly from your terminal — no MCP client required.
+
+## Features
+
+- **Image Generation** — Generate images from text prompts with multiple models
+- **Image Editing** — Edit, combine, and transform images with AI
+- **Multiple Models** — doubao-seedream-4-5-251128, doubao-seedream-4-0-250828, doubao-seedream-3-0-t2i-250415, doubao-seededit-3-0-i2i-250628
+- **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 Seedream API page
+3. Click "Acquire" to get your token
+
+### 2. Install
+
+```bash
+# Install with pip
+pip install seedream-cli
+
+# Or with uv (recommended)
+uv pip install seedream-cli
+
+# Or from source
+git clone https://github.com/AceDataCloud/SeedreamCli.git
+cd SeedreamCli
+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 an image
+seedream generate "A test image"
+
+# Edit an image
+seedream edit "Make it look like a painting" -i https://example.com/photo.jpg
+
+# Check task status
+seedream task <task-id>
+
+# Wait for completion
+seedream wait <task-id> --interval 5
+
+# List available models
+seedream models
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `seedream generate <prompt>` | Generate an image from a text prompt |
+| `seedream edit <prompt> -i <url>...` | Edit or combine images using AI |
+| `seedream task <task_id>` | Query a single task status |
+| `seedream tasks <id1> <id2>...` | Query multiple tasks at once |
+| `seedream wait <task_id>` | Wait for task completion with polling |
+| `seedream models` | List available Seedream models |
+| `seedream config` | Show current configuration |
+| `seedream resolutions` | List available output resolutions |
+
+
+## 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    Seedream model version (default: doubao-seedream-4-0-250828)
+```
+
+## Available Models
+
+| Model | Version | Notes |
+|-------|---------|-------|
+| `doubao-seedream-4-5-251128` | V4.5 | Flagship model, best quality |
+| `doubao-seedream-4-0-250828` | V4.0 | Standard quality (default) |
+| `doubao-seedream-3-0-t2i-250415` | V3.0 T2I | Text-to-image generation |
+| `doubao-seededit-3-0-i2i-250628` | V3.0 I2I | Image-to-image editing |
+
+
+## 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` |
+| `SEEDREAM_DEFAULT_MODEL` | Default model | `doubao-seedream-4-0-250828` |
+| `SEEDREAM_REQUEST_TIMEOUT` | Timeout in seconds | `1800` |
+
+## Development
+
+### Setup Development Environment
+
+```bash
+git clone https://github.com/AceDataCloud/SeedreamCli.git
+cd SeedreamCli
+python -m venv .venv
+source .venv/bin/activate
+pip install -e ".[dev,test]"
+```
+
+### Run Tests
+
+```bash
+pytest
+pytest --cov=seedream_cli
+pytest tests/test_integration.py -m integration
+```
+
+### Code Quality
+
+```bash
+ruff format .
+ruff check .
+mypy seedream_cli
+```
+
+## Docker
+
+```bash
+docker pull ghcr.io/acedatacloud/seedream-cli:latest
+docker run --rm -e ACEDATACLOUD_API_TOKEN=your_token \
+  ghcr.io/acedatacloud/seedream-cli generate "A test image"
+```
+
+## Project Structure
+
+```
+SeedreamCli/
+├── seedream_cli/                # Main package
+│   ├── __init__.py
+│   ├── __main__.py            # python -m seedream_cli entry point
+│   ├── main.py                # CLI entry point
+│   ├── core/                  # Core modules
+│   │   ├── client.py          # HTTP client for Seedream API
+│   │   ├── config.py          # Configuration management
+│   │   ├── exceptions.py      # Custom exceptions
+│   │   └── output.py          # Rich terminal formatting
+│   └── commands/              # CLI command groups
+│       ├── image.py           # Image 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
+```
+
+## Seedream CLI vs MCP Seedream
+
+| Feature | Seedream CLI | MCP Seedream |
+|---------|-----------|-----------|
+| 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 seedream-cli` | `pip install mcp-seedream` |
+
+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.

seedream_cli-2026.3.17.0/README.md

@@ -0,0 +1,220 @@
+# Seedream CLI
+
+[![PyPI version](https://img.shields.io/pypi/v/seedream-cli.svg)](https://pypi.org/project/seedream-cli/)
+[![PyPI downloads](https://img.shields.io/pypi/dm/seedream-cli.svg)](https://pypi.org/project/seedream-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/SeedreamCli/actions/workflows/ci.yaml/badge.svg)](https://github.com/AceDataCloud/SeedreamCli/actions/workflows/ci.yaml)
+
+A command-line tool for AI image generation using [Seedream](https://platform.acedata.cloud/) through the [AceDataCloud API](https://platform.acedata.cloud/).
+
+Generate AI images directly from your terminal — no MCP client required.
+
+## Features
+
+- **Image Generation** — Generate images from text prompts with multiple models
+- **Image Editing** — Edit, combine, and transform images with AI
+- **Multiple Models** — doubao-seedream-4-5-251128, doubao-seedream-4-0-250828, doubao-seedream-3-0-t2i-250415, doubao-seededit-3-0-i2i-250628
+- **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 Seedream API page
+3. Click "Acquire" to get your token
+
+### 2. Install
+
+```bash
+# Install with pip
+pip install seedream-cli
+
+# Or with uv (recommended)
+uv pip install seedream-cli
+
+# Or from source
+git clone https://github.com/AceDataCloud/SeedreamCli.git
+cd SeedreamCli
+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 an image
+seedream generate "A test image"
+
+# Edit an image
+seedream edit "Make it look like a painting" -i https://example.com/photo.jpg
+
+# Check task status
+seedream task <task-id>
+
+# Wait for completion
+seedream wait <task-id> --interval 5
+
+# List available models
+seedream models
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `seedream generate <prompt>` | Generate an image from a text prompt |
+| `seedream edit <prompt> -i <url>...` | Edit or combine images using AI |
+| `seedream task <task_id>` | Query a single task status |
+| `seedream tasks <id1> <id2>...` | Query multiple tasks at once |
+| `seedream wait <task_id>` | Wait for task completion with polling |
+| `seedream models` | List available Seedream models |
+| `seedream config` | Show current configuration |
+| `seedream resolutions` | List available output resolutions |
+
+
+## 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    Seedream model version (default: doubao-seedream-4-0-250828)
+```
+
+## Available Models
+
+| Model | Version | Notes |
+|-------|---------|-------|
+| `doubao-seedream-4-5-251128` | V4.5 | Flagship model, best quality |
+| `doubao-seedream-4-0-250828` | V4.0 | Standard quality (default) |
+| `doubao-seedream-3-0-t2i-250415` | V3.0 T2I | Text-to-image generation |
+| `doubao-seededit-3-0-i2i-250628` | V3.0 I2I | Image-to-image editing |
+
+
+## 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` |
+| `SEEDREAM_DEFAULT_MODEL` | Default model | `doubao-seedream-4-0-250828` |
+| `SEEDREAM_REQUEST_TIMEOUT` | Timeout in seconds | `1800` |
+
+## Development
+
+### Setup Development Environment
+
+```bash
+git clone https://github.com/AceDataCloud/SeedreamCli.git
+cd SeedreamCli
+python -m venv .venv
+source .venv/bin/activate
+pip install -e ".[dev,test]"
+```
+
+### Run Tests
+
+```bash
+pytest
+pytest --cov=seedream_cli
+pytest tests/test_integration.py -m integration
+```
+
+### Code Quality
+
+```bash
+ruff format .
+ruff check .
+mypy seedream_cli
+```
+
+## Docker
+
+```bash
+docker pull ghcr.io/acedatacloud/seedream-cli:latest
+docker run --rm -e ACEDATACLOUD_API_TOKEN=your_token \
+  ghcr.io/acedatacloud/seedream-cli generate "A test image"
+```
+
+## Project Structure
+
+```
+SeedreamCli/
+├── seedream_cli/                # Main package
+│   ├── __init__.py
+│   ├── __main__.py            # python -m seedream_cli entry point
+│   ├── main.py                # CLI entry point
+│   ├── core/                  # Core modules
+│   │   ├── client.py          # HTTP client for Seedream API
+│   │   ├── config.py          # Configuration management
+│   │   ├── exceptions.py      # Custom exceptions
+│   │   └── output.py          # Rich terminal formatting
+│   └── commands/              # CLI command groups
+│       ├── image.py           # Image 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
+```
+
+## Seedream CLI vs MCP Seedream
+
+| Feature | Seedream CLI | MCP Seedream |
+|---------|-----------|-----------|
+| 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 seedream-cli` | `pip install mcp-seedream` |
+
+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.

seedream_cli-2026.3.17.0/pyproject.toml

@@ -0,0 +1,118 @@
+[project]
+name = "seedream-cli"
+version = "2026.3.17.0"
+description = "CLI tool for Seedream AI Image Generation via AceDataCloud API"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.10"
+authors = [
+    { name = "AceDataCloud", email = "support@acedata.cloud" }
+]
+maintainers = [
+    { name = "AceDataCloud", email = "support@acedata.cloud" }
+]
+keywords = [
+    "cli",
+    "seedream",
+    "ai",
+    "image",
+    "generation",
+    "acedata",
+    "command-line"
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Multimedia :: Graphics",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Environment :: Console",
+]
+dependencies = [
+    "click>=8.1.0",
+    "httpx>=0.27.0",
+    "python-dotenv>=1.0.0",
+    "rich>=13.0.0",
+    "pydantic>=2.0.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "ruff>=0.4.0",
+    "mypy>=1.10.0",
+    "pre-commit>=3.7.0",
+]
+test = [
+    "pytest>=8.0.0",
+    "pytest-asyncio>=0.23.0",
+    "pytest-cov>=5.0.0",
+    "respx>=0.21.0",
+]
+release = [
+    "build>=1.2.0",
+    "twine>=6.1.0",
+]
+all = [
+    "seedream-cli[dev,test,release]",
+]
+
+[project.scripts]
+seedream-cli = "seedream_cli.main:cli"
+seedream = "seedream_cli.main:cli"
+
+[project.urls]
+Homepage = "https://github.com/AceDataCloud/SeedreamCli"
+Repository = "https://github.com/AceDataCloud/SeedreamCli"
+Issues = "https://github.com/AceDataCloud/SeedreamCli/issues"
+Changelog = "https://github.com/AceDataCloud/SeedreamCli/blob/main/CHANGELOG.md"
+
+[build-system]
+requires = ["hatchling>=1.21.0,<1.22.0"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["seedream_cli"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "seedream_cli/",
+    "tests/",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md",
+    ".env.example",
+]
+
+# Mypy Configuration
+[tool.mypy]
+python_version = "3.10"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true
+check_untyped_defs = true
+
+# Pytest Configuration
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"
+markers = [
+    "integration: marks tests that require real API access",
+    "slow: marks slow tests",
+]
+
+# Ruff Configuration
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E", "W", "F", "I", "B", "C4", "UP", "ARG", "SIM"]
+ignore = ["E501"]
+
+[tool.ruff.format]
+quote-style = "double"

seedream_cli-2026.3.17.0/seedream_cli/__init__.py

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

seedream_cli-2026.3.17.0/seedream_cli/__main__.py

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

seedream_cli-2026.3.17.0/seedream_cli/commands/__init__.py

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