sora-pro-cli 2026.3.18.0__tar.gz

sora_pro_cli-2026.3.18.0/.env.example

@@ -0,0 +1,5 @@
+# Sora CLI Environment
+ACEDATACLOUD_API_TOKEN=your_api_token_here
+# ACEDATACLOUD_API_BASE_URL=https://api.acedata.cloud
+# SORA_DEFAULT_MODEL=sora-2
+# SORA_REQUEST_TIMEOUT=1800

sora_pro_cli-2026.3.18.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/

sora_pro_cli-2026.3.18.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
+- Sora video generation from text prompts
+- Image-to-video generation
+- Task management with polling
+- Rich terminal output with tables and panels
+- JSON output mode (`--json` flag)
+- Multiple model support

sora_pro_cli-2026.3.18.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.

sora_pro_cli-2026.3.18.0/PKG-INFO

@@ -0,0 +1,265 @@
+Metadata-Version: 2.1
+Name: sora-pro-cli
+Version: 2026.3.18.0
+Summary: CLI tool for Sora AI Video Generation via AceDataCloud API
+Project-URL: Homepage, https://github.com/AceDataCloud/SoraCli
+Project-URL: Repository, https://github.com/AceDataCloud/SoraCli
+Project-URL: Issues, https://github.com/AceDataCloud/SoraCli/issues
+Project-URL: Changelog, https://github.com/AceDataCloud/SoraCli/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,sora,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: sora-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
+
+# Sora CLI
+
+[![PyPI version](https://img.shields.io/pypi/v/sora-pro-cli.svg)](https://pypi.org/project/sora-pro-cli/)
+[![PyPI downloads](https://img.shields.io/pypi/dm/sora-pro-cli.svg)](https://pypi.org/project/sora-pro-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/SoraCli/actions/workflows/ci.yaml/badge.svg)](https://github.com/AceDataCloud/SoraCli/actions/workflows/ci.yaml)
+
+A command-line tool for AI video generation using [Sora](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
+- **Multiple Models** — sora-2, sora-2-pro
+- **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 Sora API page
+3. Click "Acquire" to get your token
+
+### 2. Install
+
+```bash
+# Install with pip
+pip install sora-pro-cli
+
+# Or with uv (recommended)
+uv pip install sora-pro-cli
+
+# Or from source
+git clone https://github.com/AceDataCloud/SoraCli.git
+cd SoraCli
+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
+sora generate "A test video"
+
+# Generate from reference image
+sora image-to-video "Animate this scene" -i https://example.com/photo.jpg
+
+# Check task status
+sora task <task-id>
+
+# Wait for completion
+sora wait <task-id> --interval 5
+
+# List available models
+sora models
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `sora generate <prompt>` | Generate a video from a text prompt |
+| `sora image-to-video <prompt> -i <url>` | Generate a video from reference image(s) |
+| `sora task <task_id>` | Query a single task status |
+| `sora tasks <id1> <id2>...` | Query multiple tasks at once |
+| `sora wait <task_id>` | Wait for task completion with polling |
+| `sora models` | List available Sora models |
+| `sora config` | Show current configuration |
+| `sora orientations` | List available orientations |
+| `sora sizes` | List available video sizes |
+
+
+## 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    Sora model version (default: sora-2)
+```
+
+## Available Models
+
+| Model | Version | Notes |
+|-------|---------|-------|
+| `sora-2` | Standard | Fast generation, good quality (default) |
+| `sora-2-pro` | Pro | Highest quality, more detailed |
+
+
+## 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` |
+| `SORA_DEFAULT_MODEL` | Default model | `sora-2` |
+| `SORA_REQUEST_TIMEOUT` | Timeout in seconds | `1800` |
+
+## Development
+
+### Setup Development Environment
+
+```bash
+git clone https://github.com/AceDataCloud/SoraCli.git
+cd SoraCli
+python -m venv .venv
+source .venv/bin/activate
+pip install -e ".[dev,test]"
+```
+
+### Run Tests
+
+```bash
+pytest
+pytest --cov=sora_cli
+pytest tests/test_integration.py -m integration
+```
+
+### Code Quality
+
+```bash
+ruff format .
+ruff check .
+mypy sora_cli
+```
+
+## Docker
+
+```bash
+docker pull ghcr.io/acedatacloud/sora-pro-cli:latest
+docker run --rm -e ACEDATACLOUD_API_TOKEN=your_token \
+  ghcr.io/acedatacloud/sora-pro-cli generate "A test video"
+```
+
+## Project Structure
+
+```
+SoraCli/
+├── sora_cli/                # Main package
+│   ├── __init__.py
+│   ├── __main__.py            # python -m sora_cli entry point
+│   ├── main.py                # CLI entry point
+│   ├── core/                  # Core modules
+│   │   ├── client.py          # HTTP client for Sora 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
+```
+
+## Sora CLI vs MCP Sora
+
+| Feature | Sora CLI | MCP Sora |
+|---------|-----------|-----------|
+| 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 sora-pro-cli` | `pip install mcp-sora` |
+
+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.

sora_pro_cli-2026.3.18.0/README.md

@@ -0,0 +1,219 @@
+# Sora CLI
+
+[![PyPI version](https://img.shields.io/pypi/v/sora-pro-cli.svg)](https://pypi.org/project/sora-pro-cli/)
+[![PyPI downloads](https://img.shields.io/pypi/dm/sora-pro-cli.svg)](https://pypi.org/project/sora-pro-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/SoraCli/actions/workflows/ci.yaml/badge.svg)](https://github.com/AceDataCloud/SoraCli/actions/workflows/ci.yaml)
+
+A command-line tool for AI video generation using [Sora](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
+- **Multiple Models** — sora-2, sora-2-pro
+- **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 Sora API page
+3. Click "Acquire" to get your token
+
+### 2. Install
+
+```bash
+# Install with pip
+pip install sora-pro-cli
+
+# Or with uv (recommended)
+uv pip install sora-pro-cli
+
+# Or from source
+git clone https://github.com/AceDataCloud/SoraCli.git
+cd SoraCli
+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
+sora generate "A test video"
+
+# Generate from reference image
+sora image-to-video "Animate this scene" -i https://example.com/photo.jpg
+
+# Check task status
+sora task <task-id>
+
+# Wait for completion
+sora wait <task-id> --interval 5
+
+# List available models
+sora models
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `sora generate <prompt>` | Generate a video from a text prompt |
+| `sora image-to-video <prompt> -i <url>` | Generate a video from reference image(s) |
+| `sora task <task_id>` | Query a single task status |
+| `sora tasks <id1> <id2>...` | Query multiple tasks at once |
+| `sora wait <task_id>` | Wait for task completion with polling |
+| `sora models` | List available Sora models |
+| `sora config` | Show current configuration |
+| `sora orientations` | List available orientations |
+| `sora sizes` | List available video sizes |
+
+
+## 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    Sora model version (default: sora-2)
+```
+
+## Available Models
+
+| Model | Version | Notes |
+|-------|---------|-------|
+| `sora-2` | Standard | Fast generation, good quality (default) |
+| `sora-2-pro` | Pro | Highest quality, more detailed |
+
+
+## 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` |
+| `SORA_DEFAULT_MODEL` | Default model | `sora-2` |
+| `SORA_REQUEST_TIMEOUT` | Timeout in seconds | `1800` |
+
+## Development
+
+### Setup Development Environment
+
+```bash
+git clone https://github.com/AceDataCloud/SoraCli.git
+cd SoraCli
+python -m venv .venv
+source .venv/bin/activate
+pip install -e ".[dev,test]"
+```
+
+### Run Tests
+
+```bash
+pytest
+pytest --cov=sora_cli
+pytest tests/test_integration.py -m integration
+```
+
+### Code Quality
+
+```bash
+ruff format .
+ruff check .
+mypy sora_cli
+```
+
+## Docker
+
+```bash
+docker pull ghcr.io/acedatacloud/sora-pro-cli:latest
+docker run --rm -e ACEDATACLOUD_API_TOKEN=your_token \
+  ghcr.io/acedatacloud/sora-pro-cli generate "A test video"
+```
+
+## Project Structure
+
+```
+SoraCli/
+├── sora_cli/                # Main package
+│   ├── __init__.py
+│   ├── __main__.py            # python -m sora_cli entry point
+│   ├── main.py                # CLI entry point
+│   ├── core/                  # Core modules
+│   │   ├── client.py          # HTTP client for Sora 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
+```
+
+## Sora CLI vs MCP Sora
+
+| Feature | Sora CLI | MCP Sora |
+|---------|-----------|-----------|
+| 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 sora-pro-cli` | `pip install mcp-sora` |
+
+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.

sora_pro_cli-2026.3.18.0/pyproject.toml

@@ -0,0 +1,119 @@
+[project]
+name = "sora-pro-cli"
+version = "2026.3.18.0"
+description = "CLI tool for Sora AI Video 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",
+    "sora",
+    "ai",
+    "video",
+    "video",
+    "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 :: Video",
+    "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 = [
+    "sora-cli[dev,test,release]",
+]
+
+[project.scripts]
+sora-cli = "sora_cli.main:cli"
+sora = "sora_cli.main:cli"
+
+[project.urls]
+Homepage = "https://github.com/AceDataCloud/SoraCli"
+Repository = "https://github.com/AceDataCloud/SoraCli"
+Issues = "https://github.com/AceDataCloud/SoraCli/issues"
+Changelog = "https://github.com/AceDataCloud/SoraCli/blob/main/CHANGELOG.md"
+
+[build-system]
+requires = ["hatchling>=1.21.0,<1.22.0"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["sora_cli"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "sora_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"

sora_pro_cli-2026.3.18.0/sora_cli/__init__.py

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

sora_pro_cli-2026.3.18.0/sora_cli/__main__.py

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

sora_pro_cli-2026.3.18.0/sora_cli/commands/__init__.py

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