veo-cli 2026.3.17.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- veo_cli-2026.3.17.0/.env.example +5 -0
- veo_cli-2026.3.17.0/.gitignore +32 -0
- veo_cli-2026.3.17.0/CHANGELOG.md +18 -0
- veo_cli-2026.3.17.0/LICENSE +21 -0
- veo_cli-2026.3.17.0/PKG-INFO +272 -0
- veo_cli-2026.3.17.0/README.md +226 -0
- veo_cli-2026.3.17.0/pyproject.toml +119 -0
- veo_cli-2026.3.17.0/tests/__init__.py +0 -0
- veo_cli-2026.3.17.0/tests/conftest.py +76 -0
- veo_cli-2026.3.17.0/tests/test_client.py +116 -0
- veo_cli-2026.3.17.0/tests/test_commands.py +193 -0
- veo_cli-2026.3.17.0/tests/test_config.py +56 -0
- veo_cli-2026.3.17.0/tests/test_integration.py +37 -0
- veo_cli-2026.3.17.0/tests/test_output.py +117 -0
- veo_cli-2026.3.17.0/veo_cli/__init__.py +1 -0
- veo_cli-2026.3.17.0/veo_cli/__main__.py +5 -0
- veo_cli-2026.3.17.0/veo_cli/commands/__init__.py +1 -0
- veo_cli-2026.3.17.0/veo_cli/commands/info.py +54 -0
- veo_cli-2026.3.17.0/veo_cli/commands/task.py +142 -0
- veo_cli-2026.3.17.0/veo_cli/commands/video.py +161 -0
- veo_cli-2026.3.17.0/veo_cli/core/__init__.py +1 -0
- veo_cli-2026.3.17.0/veo_cli/core/client.py +111 -0
- veo_cli-2026.3.17.0/veo_cli/core/config.py +42 -0
- veo_cli-2026.3.17.0/veo_cli/core/exceptions.py +37 -0
- veo_cli-2026.3.17.0/veo_cli/core/output.py +153 -0
- veo_cli-2026.3.17.0/veo_cli/main.py +70 -0
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
# Byte-compiled / optimized / DLL files
|
|
2
|
+
__pycache__/
|
|
3
|
+
*.py[cod]
|
|
4
|
+
*$py.class
|
|
5
|
+
|
|
6
|
+
# Distribution / packaging
|
|
7
|
+
dist/
|
|
8
|
+
build/
|
|
9
|
+
*.egg-info/
|
|
10
|
+
*.egg
|
|
11
|
+
|
|
12
|
+
# Virtual environments
|
|
13
|
+
.venv/
|
|
14
|
+
venv/
|
|
15
|
+
ENV/
|
|
16
|
+
|
|
17
|
+
# Environment variables
|
|
18
|
+
.env
|
|
19
|
+
|
|
20
|
+
# IDE
|
|
21
|
+
.vscode/
|
|
22
|
+
.idea/
|
|
23
|
+
*.swp
|
|
24
|
+
*.swo
|
|
25
|
+
|
|
26
|
+
# Testing
|
|
27
|
+
.coverage
|
|
28
|
+
htmlcov/
|
|
29
|
+
.pytest_cache/
|
|
30
|
+
|
|
31
|
+
# mypy
|
|
32
|
+
.mypy_cache/
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
All notable changes to this project will be documented in this file.
|
|
4
|
+
|
|
5
|
+
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
|
|
6
|
+
and this project adheres to [Calendar Versioning](https://calver.org/) (YYYY.MM.DD.BUILD).
|
|
7
|
+
|
|
8
|
+
## [0.1.0] - 2026-03-18
|
|
9
|
+
|
|
10
|
+
### Added
|
|
11
|
+
- Initial release
|
|
12
|
+
- Veo video generation from text prompts
|
|
13
|
+
- Image-to-video generation
|
|
14
|
+
- Video upscale to 1080p
|
|
15
|
+
- Task management with polling
|
|
16
|
+
- Rich terminal output with tables and panels
|
|
17
|
+
- JSON output mode (`--json` flag)
|
|
18
|
+
- Multiple model support
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 AceDataCloud
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
|
@@ -0,0 +1,272 @@
|
|
|
1
|
+
Metadata-Version: 2.1
|
|
2
|
+
Name: veo-cli
|
|
3
|
+
Version: 2026.3.17.0
|
|
4
|
+
Summary: CLI tool for Google Veo AI Video Generation via AceDataCloud API
|
|
5
|
+
Project-URL: Homepage, https://github.com/AceDataCloud/VeoCli
|
|
6
|
+
Project-URL: Repository, https://github.com/AceDataCloud/VeoCli
|
|
7
|
+
Project-URL: Issues, https://github.com/AceDataCloud/VeoCli/issues
|
|
8
|
+
Project-URL: Changelog, https://github.com/AceDataCloud/VeoCli/blob/main/CHANGELOG.md
|
|
9
|
+
Author-email: AceDataCloud <support@acedata.cloud>
|
|
10
|
+
Maintainer-email: AceDataCloud <support@acedata.cloud>
|
|
11
|
+
License: MIT
|
|
12
|
+
License-File: LICENSE
|
|
13
|
+
Keywords: acedata,ai,cli,command-line,generation,veo,video
|
|
14
|
+
Classifier: Development Status :: 4 - Beta
|
|
15
|
+
Classifier: Environment :: Console
|
|
16
|
+
Classifier: Intended Audience :: Developers
|
|
17
|
+
Classifier: License :: OSI Approved :: MIT License
|
|
18
|
+
Classifier: Operating System :: OS Independent
|
|
19
|
+
Classifier: Programming Language :: Python :: 3
|
|
20
|
+
Classifier: Programming Language :: Python :: 3.10
|
|
21
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
22
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
23
|
+
Classifier: Topic :: Multimedia :: Video
|
|
24
|
+
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
|
|
25
|
+
Requires-Python: >=3.10
|
|
26
|
+
Requires-Dist: click>=8.1.0
|
|
27
|
+
Requires-Dist: httpx>=0.27.0
|
|
28
|
+
Requires-Dist: pydantic>=2.0.0
|
|
29
|
+
Requires-Dist: python-dotenv>=1.0.0
|
|
30
|
+
Requires-Dist: rich>=13.0.0
|
|
31
|
+
Provides-Extra: all
|
|
32
|
+
Requires-Dist: veo-cli[dev,release,test]; extra == 'all'
|
|
33
|
+
Provides-Extra: dev
|
|
34
|
+
Requires-Dist: mypy>=1.10.0; extra == 'dev'
|
|
35
|
+
Requires-Dist: pre-commit>=3.7.0; extra == 'dev'
|
|
36
|
+
Requires-Dist: ruff>=0.4.0; extra == 'dev'
|
|
37
|
+
Provides-Extra: release
|
|
38
|
+
Requires-Dist: build>=1.2.0; extra == 'release'
|
|
39
|
+
Requires-Dist: twine>=6.1.0; extra == 'release'
|
|
40
|
+
Provides-Extra: test
|
|
41
|
+
Requires-Dist: pytest-asyncio>=0.23.0; extra == 'test'
|
|
42
|
+
Requires-Dist: pytest-cov>=5.0.0; extra == 'test'
|
|
43
|
+
Requires-Dist: pytest>=8.0.0; extra == 'test'
|
|
44
|
+
Requires-Dist: respx>=0.21.0; extra == 'test'
|
|
45
|
+
Description-Content-Type: text/markdown
|
|
46
|
+
|
|
47
|
+
# Veo CLI
|
|
48
|
+
|
|
49
|
+
[](https://pypi.org/project/veo-cli/)
|
|
50
|
+
[](https://pypi.org/project/veo-cli/)
|
|
51
|
+
[](https://www.python.org/downloads/)
|
|
52
|
+
[](https://opensource.org/licenses/MIT)
|
|
53
|
+
[](https://github.com/AceDataCloud/VeoCli/actions/workflows/ci.yaml)
|
|
54
|
+
|
|
55
|
+
A command-line tool for AI video generation using [Veo](https://platform.acedata.cloud/) through the [AceDataCloud API](https://platform.acedata.cloud/).
|
|
56
|
+
|
|
57
|
+
Generate AI videos directly from your terminal — no MCP client required.
|
|
58
|
+
|
|
59
|
+
## Features
|
|
60
|
+
|
|
61
|
+
- **Video Generation** — Generate videos from text prompts with multiple models
|
|
62
|
+
- **Image-to-Video** — Create videos from reference images- **Video Upscale** — Get 1080p versions of generated videos
|
|
63
|
+
- **Multiple Models** — veo3, veo3-fast, veo31, veo31-fast, veo2, veo2-fast
|
|
64
|
+
- **Task Management** — Query tasks, batch query, wait with polling
|
|
65
|
+
- **Rich Output** — Beautiful terminal tables and panels via Rich
|
|
66
|
+
- **JSON Mode** — Machine-readable output with `--json` for piping
|
|
67
|
+
|
|
68
|
+
## Quick Start
|
|
69
|
+
|
|
70
|
+
### 1. Get API Token
|
|
71
|
+
|
|
72
|
+
Get your API token from [AceDataCloud Platform](https://platform.acedata.cloud/):
|
|
73
|
+
|
|
74
|
+
1. Sign up or log in
|
|
75
|
+
2. Navigate to the Veo API page
|
|
76
|
+
3. Click "Acquire" to get your token
|
|
77
|
+
|
|
78
|
+
### 2. Install
|
|
79
|
+
|
|
80
|
+
```bash
|
|
81
|
+
# Install with pip
|
|
82
|
+
pip install veo-cli
|
|
83
|
+
|
|
84
|
+
# Or with uv (recommended)
|
|
85
|
+
uv pip install veo-cli
|
|
86
|
+
|
|
87
|
+
# Or from source
|
|
88
|
+
git clone https://github.com/AceDataCloud/VeoCli.git
|
|
89
|
+
cd VeoCli
|
|
90
|
+
pip install -e .
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
### 3. Configure
|
|
94
|
+
|
|
95
|
+
```bash
|
|
96
|
+
# Set your API token
|
|
97
|
+
export ACEDATACLOUD_API_TOKEN=your_token_here
|
|
98
|
+
|
|
99
|
+
# Or use .env file
|
|
100
|
+
cp .env.example .env
|
|
101
|
+
# Edit .env with your token
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
### 4. Use
|
|
105
|
+
|
|
106
|
+
```bash
|
|
107
|
+
# Generate a video
|
|
108
|
+
veo generate "A test video"
|
|
109
|
+
|
|
110
|
+
# Generate from reference image
|
|
111
|
+
veo image-to-video "Animate this scene" -i https://example.com/photo.jpg
|
|
112
|
+
|
|
113
|
+
# Upscale to 1080p
|
|
114
|
+
veo upscale <video-id>
|
|
115
|
+
|
|
116
|
+
# Check task status
|
|
117
|
+
veo task <task-id>
|
|
118
|
+
|
|
119
|
+
# Wait for completion
|
|
120
|
+
veo wait <task-id> --interval 5
|
|
121
|
+
|
|
122
|
+
# List available models
|
|
123
|
+
veo models
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
## Commands
|
|
127
|
+
|
|
128
|
+
| Command | Description |
|
|
129
|
+
|---------|-------------|
|
|
130
|
+
| `veo generate <prompt>` | Generate a video from a text prompt |
|
|
131
|
+
| `veo image-to-video <prompt> -i <url>` | Generate a video from reference image(s) |
|
|
132
|
+
| `veo upscale <video_id>` | Get 1080p version of a generated video |
|
|
133
|
+
| `veo task <task_id>` | Query a single task status |
|
|
134
|
+
| `veo tasks <id1> <id2>...` | Query multiple tasks at once |
|
|
135
|
+
| `veo wait <task_id>` | Wait for task completion with polling |
|
|
136
|
+
| `veo models` | List available Veo models |
|
|
137
|
+
| `veo config` | Show current configuration |
|
|
138
|
+
| `veo aspect-ratios` | List available aspect ratios |
|
|
139
|
+
|
|
140
|
+
|
|
141
|
+
## Global Options
|
|
142
|
+
|
|
143
|
+
```
|
|
144
|
+
--token TEXT API token (or set ACEDATACLOUD_API_TOKEN env var)
|
|
145
|
+
--version Show version
|
|
146
|
+
--help Show help message
|
|
147
|
+
```
|
|
148
|
+
|
|
149
|
+
Most commands support:
|
|
150
|
+
|
|
151
|
+
```
|
|
152
|
+
--json Output raw JSON (for piping/scripting)
|
|
153
|
+
--model TEXT Veo model version (default: veo3)
|
|
154
|
+
```
|
|
155
|
+
|
|
156
|
+
## Available Models
|
|
157
|
+
|
|
158
|
+
| Model | Version | Notes |
|
|
159
|
+
|-------|---------|-------|
|
|
160
|
+
| `veo3` | V3 | Latest model, best quality (default) |
|
|
161
|
+
| `veo3-fast` | V3 Fast | Fast generation |
|
|
162
|
+
| `veo31` | V3.1 | Next generation model |
|
|
163
|
+
| `veo31-fast` | V3.1 Fast | Fast next-gen model |
|
|
164
|
+
| `veo2` | V2 | Previous generation, stable |
|
|
165
|
+
| `veo2-fast` | V2 Fast | Fast previous-gen model |
|
|
166
|
+
|
|
167
|
+
|
|
168
|
+
## Configuration
|
|
169
|
+
|
|
170
|
+
### Environment Variables
|
|
171
|
+
|
|
172
|
+
| Variable | Description | Default |
|
|
173
|
+
|----------|-------------|---------|
|
|
174
|
+
| `ACEDATACLOUD_API_TOKEN` | API token from AceDataCloud | *Required* |
|
|
175
|
+
| `ACEDATACLOUD_API_BASE_URL` | API base URL | `https://api.acedata.cloud` |
|
|
176
|
+
| `VEO_DEFAULT_MODEL` | Default model | `veo3` |
|
|
177
|
+
| `VEO_REQUEST_TIMEOUT` | Timeout in seconds | `1800` |
|
|
178
|
+
|
|
179
|
+
## Development
|
|
180
|
+
|
|
181
|
+
### Setup Development Environment
|
|
182
|
+
|
|
183
|
+
```bash
|
|
184
|
+
git clone https://github.com/AceDataCloud/VeoCli.git
|
|
185
|
+
cd VeoCli
|
|
186
|
+
python -m venv .venv
|
|
187
|
+
source .venv/bin/activate
|
|
188
|
+
pip install -e ".[dev,test]"
|
|
189
|
+
```
|
|
190
|
+
|
|
191
|
+
### Run Tests
|
|
192
|
+
|
|
193
|
+
```bash
|
|
194
|
+
pytest
|
|
195
|
+
pytest --cov=veo_cli
|
|
196
|
+
pytest tests/test_integration.py -m integration
|
|
197
|
+
```
|
|
198
|
+
|
|
199
|
+
### Code Quality
|
|
200
|
+
|
|
201
|
+
```bash
|
|
202
|
+
ruff format .
|
|
203
|
+
ruff check .
|
|
204
|
+
mypy veo_cli
|
|
205
|
+
```
|
|
206
|
+
|
|
207
|
+
## Docker
|
|
208
|
+
|
|
209
|
+
```bash
|
|
210
|
+
docker pull ghcr.io/acedatacloud/veo-cli:latest
|
|
211
|
+
docker run --rm -e ACEDATACLOUD_API_TOKEN=your_token \
|
|
212
|
+
ghcr.io/acedatacloud/veo-cli generate "A test video"
|
|
213
|
+
```
|
|
214
|
+
|
|
215
|
+
## Project Structure
|
|
216
|
+
|
|
217
|
+
```
|
|
218
|
+
VeoCli/
|
|
219
|
+
├── veo_cli/ # Main package
|
|
220
|
+
│ ├── __init__.py
|
|
221
|
+
│ ├── __main__.py # python -m veo_cli entry point
|
|
222
|
+
│ ├── main.py # CLI entry point
|
|
223
|
+
│ ├── core/ # Core modules
|
|
224
|
+
│ │ ├── client.py # HTTP client for Veo API
|
|
225
|
+
│ │ ├── config.py # Configuration management
|
|
226
|
+
│ │ ├── exceptions.py # Custom exceptions
|
|
227
|
+
│ │ └── output.py # Rich terminal formatting
|
|
228
|
+
│ └── commands/ # CLI command groups
|
|
229
|
+
│ ├── video.py # Video generation commands
|
|
230
|
+
│ ├── task.py # Task management commands
|
|
231
|
+
│ └── info.py # Info & utility commands
|
|
232
|
+
├── tests/ # Test suite
|
|
233
|
+
├── .github/workflows/ # CI/CD (lint, test, publish to PyPI)
|
|
234
|
+
├── Dockerfile # Container image
|
|
235
|
+
├── deploy/ # Kubernetes deployment configs
|
|
236
|
+
├── .env.example # Environment template
|
|
237
|
+
├── pyproject.toml # Project configuration
|
|
238
|
+
└── README.md
|
|
239
|
+
```
|
|
240
|
+
|
|
241
|
+
## Veo CLI vs MCP Veo
|
|
242
|
+
|
|
243
|
+
| Feature | Veo CLI | MCP Veo |
|
|
244
|
+
|---------|-----------|-----------|
|
|
245
|
+
| Interface | Terminal commands | MCP protocol |
|
|
246
|
+
| Usage | Direct shell, scripts, CI/CD | Claude, VS Code, MCP clients |
|
|
247
|
+
| Output | Rich tables / JSON | Structured MCP responses |
|
|
248
|
+
| Automation | Shell scripts, piping | AI agent workflows |
|
|
249
|
+
| Install | `pip install veo-cli` | `pip install mcp-veo` |
|
|
250
|
+
|
|
251
|
+
Both tools use the same AceDataCloud API and share the same API token.
|
|
252
|
+
|
|
253
|
+
## Contributing
|
|
254
|
+
|
|
255
|
+
Contributions are welcome! Please:
|
|
256
|
+
|
|
257
|
+
1. Fork the repository
|
|
258
|
+
2. Create a feature branch (`git checkout -b feature/amazing`)
|
|
259
|
+
3. Commit your changes (`git commit -m 'Add amazing feature'`)
|
|
260
|
+
4. Push to the branch (`git push origin feature/amazing`)
|
|
261
|
+
5. Open a Pull Request
|
|
262
|
+
|
|
263
|
+
### Development Requirements
|
|
264
|
+
|
|
265
|
+
- Python 3.10+
|
|
266
|
+
- Dependencies: `pip install -e ".[all]"`
|
|
267
|
+
- Lint: `ruff check . && ruff format --check .`
|
|
268
|
+
- Test: `pytest`
|
|
269
|
+
|
|
270
|
+
## License
|
|
271
|
+
|
|
272
|
+
This project is licensed under the MIT License — see the [LICENSE](LICENSE) file for details.
|
|
@@ -0,0 +1,226 @@
|
|
|
1
|
+
# Veo CLI
|
|
2
|
+
|
|
3
|
+
[](https://pypi.org/project/veo-cli/)
|
|
4
|
+
[](https://pypi.org/project/veo-cli/)
|
|
5
|
+
[](https://www.python.org/downloads/)
|
|
6
|
+
[](https://opensource.org/licenses/MIT)
|
|
7
|
+
[](https://github.com/AceDataCloud/VeoCli/actions/workflows/ci.yaml)
|
|
8
|
+
|
|
9
|
+
A command-line tool for AI video generation using [Veo](https://platform.acedata.cloud/) through the [AceDataCloud API](https://platform.acedata.cloud/).
|
|
10
|
+
|
|
11
|
+
Generate AI videos directly from your terminal — no MCP client required.
|
|
12
|
+
|
|
13
|
+
## Features
|
|
14
|
+
|
|
15
|
+
- **Video Generation** — Generate videos from text prompts with multiple models
|
|
16
|
+
- **Image-to-Video** — Create videos from reference images- **Video Upscale** — Get 1080p versions of generated videos
|
|
17
|
+
- **Multiple Models** — veo3, veo3-fast, veo31, veo31-fast, veo2, veo2-fast
|
|
18
|
+
- **Task Management** — Query tasks, batch query, wait with polling
|
|
19
|
+
- **Rich Output** — Beautiful terminal tables and panels via Rich
|
|
20
|
+
- **JSON Mode** — Machine-readable output with `--json` for piping
|
|
21
|
+
|
|
22
|
+
## Quick Start
|
|
23
|
+
|
|
24
|
+
### 1. Get API Token
|
|
25
|
+
|
|
26
|
+
Get your API token from [AceDataCloud Platform](https://platform.acedata.cloud/):
|
|
27
|
+
|
|
28
|
+
1. Sign up or log in
|
|
29
|
+
2. Navigate to the Veo API page
|
|
30
|
+
3. Click "Acquire" to get your token
|
|
31
|
+
|
|
32
|
+
### 2. Install
|
|
33
|
+
|
|
34
|
+
```bash
|
|
35
|
+
# Install with pip
|
|
36
|
+
pip install veo-cli
|
|
37
|
+
|
|
38
|
+
# Or with uv (recommended)
|
|
39
|
+
uv pip install veo-cli
|
|
40
|
+
|
|
41
|
+
# Or from source
|
|
42
|
+
git clone https://github.com/AceDataCloud/VeoCli.git
|
|
43
|
+
cd VeoCli
|
|
44
|
+
pip install -e .
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
### 3. Configure
|
|
48
|
+
|
|
49
|
+
```bash
|
|
50
|
+
# Set your API token
|
|
51
|
+
export ACEDATACLOUD_API_TOKEN=your_token_here
|
|
52
|
+
|
|
53
|
+
# Or use .env file
|
|
54
|
+
cp .env.example .env
|
|
55
|
+
# Edit .env with your token
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
### 4. Use
|
|
59
|
+
|
|
60
|
+
```bash
|
|
61
|
+
# Generate a video
|
|
62
|
+
veo generate "A test video"
|
|
63
|
+
|
|
64
|
+
# Generate from reference image
|
|
65
|
+
veo image-to-video "Animate this scene" -i https://example.com/photo.jpg
|
|
66
|
+
|
|
67
|
+
# Upscale to 1080p
|
|
68
|
+
veo upscale <video-id>
|
|
69
|
+
|
|
70
|
+
# Check task status
|
|
71
|
+
veo task <task-id>
|
|
72
|
+
|
|
73
|
+
# Wait for completion
|
|
74
|
+
veo wait <task-id> --interval 5
|
|
75
|
+
|
|
76
|
+
# List available models
|
|
77
|
+
veo models
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
## Commands
|
|
81
|
+
|
|
82
|
+
| Command | Description |
|
|
83
|
+
|---------|-------------|
|
|
84
|
+
| `veo generate <prompt>` | Generate a video from a text prompt |
|
|
85
|
+
| `veo image-to-video <prompt> -i <url>` | Generate a video from reference image(s) |
|
|
86
|
+
| `veo upscale <video_id>` | Get 1080p version of a generated video |
|
|
87
|
+
| `veo task <task_id>` | Query a single task status |
|
|
88
|
+
| `veo tasks <id1> <id2>...` | Query multiple tasks at once |
|
|
89
|
+
| `veo wait <task_id>` | Wait for task completion with polling |
|
|
90
|
+
| `veo models` | List available Veo models |
|
|
91
|
+
| `veo config` | Show current configuration |
|
|
92
|
+
| `veo aspect-ratios` | List available aspect ratios |
|
|
93
|
+
|
|
94
|
+
|
|
95
|
+
## Global Options
|
|
96
|
+
|
|
97
|
+
```
|
|
98
|
+
--token TEXT API token (or set ACEDATACLOUD_API_TOKEN env var)
|
|
99
|
+
--version Show version
|
|
100
|
+
--help Show help message
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
Most commands support:
|
|
104
|
+
|
|
105
|
+
```
|
|
106
|
+
--json Output raw JSON (for piping/scripting)
|
|
107
|
+
--model TEXT Veo model version (default: veo3)
|
|
108
|
+
```
|
|
109
|
+
|
|
110
|
+
## Available Models
|
|
111
|
+
|
|
112
|
+
| Model | Version | Notes |
|
|
113
|
+
|-------|---------|-------|
|
|
114
|
+
| `veo3` | V3 | Latest model, best quality (default) |
|
|
115
|
+
| `veo3-fast` | V3 Fast | Fast generation |
|
|
116
|
+
| `veo31` | V3.1 | Next generation model |
|
|
117
|
+
| `veo31-fast` | V3.1 Fast | Fast next-gen model |
|
|
118
|
+
| `veo2` | V2 | Previous generation, stable |
|
|
119
|
+
| `veo2-fast` | V2 Fast | Fast previous-gen model |
|
|
120
|
+
|
|
121
|
+
|
|
122
|
+
## Configuration
|
|
123
|
+
|
|
124
|
+
### Environment Variables
|
|
125
|
+
|
|
126
|
+
| Variable | Description | Default |
|
|
127
|
+
|----------|-------------|---------|
|
|
128
|
+
| `ACEDATACLOUD_API_TOKEN` | API token from AceDataCloud | *Required* |
|
|
129
|
+
| `ACEDATACLOUD_API_BASE_URL` | API base URL | `https://api.acedata.cloud` |
|
|
130
|
+
| `VEO_DEFAULT_MODEL` | Default model | `veo3` |
|
|
131
|
+
| `VEO_REQUEST_TIMEOUT` | Timeout in seconds | `1800` |
|
|
132
|
+
|
|
133
|
+
## Development
|
|
134
|
+
|
|
135
|
+
### Setup Development Environment
|
|
136
|
+
|
|
137
|
+
```bash
|
|
138
|
+
git clone https://github.com/AceDataCloud/VeoCli.git
|
|
139
|
+
cd VeoCli
|
|
140
|
+
python -m venv .venv
|
|
141
|
+
source .venv/bin/activate
|
|
142
|
+
pip install -e ".[dev,test]"
|
|
143
|
+
```
|
|
144
|
+
|
|
145
|
+
### Run Tests
|
|
146
|
+
|
|
147
|
+
```bash
|
|
148
|
+
pytest
|
|
149
|
+
pytest --cov=veo_cli
|
|
150
|
+
pytest tests/test_integration.py -m integration
|
|
151
|
+
```
|
|
152
|
+
|
|
153
|
+
### Code Quality
|
|
154
|
+
|
|
155
|
+
```bash
|
|
156
|
+
ruff format .
|
|
157
|
+
ruff check .
|
|
158
|
+
mypy veo_cli
|
|
159
|
+
```
|
|
160
|
+
|
|
161
|
+
## Docker
|
|
162
|
+
|
|
163
|
+
```bash
|
|
164
|
+
docker pull ghcr.io/acedatacloud/veo-cli:latest
|
|
165
|
+
docker run --rm -e ACEDATACLOUD_API_TOKEN=your_token \
|
|
166
|
+
ghcr.io/acedatacloud/veo-cli generate "A test video"
|
|
167
|
+
```
|
|
168
|
+
|
|
169
|
+
## Project Structure
|
|
170
|
+
|
|
171
|
+
```
|
|
172
|
+
VeoCli/
|
|
173
|
+
├── veo_cli/ # Main package
|
|
174
|
+
│ ├── __init__.py
|
|
175
|
+
│ ├── __main__.py # python -m veo_cli entry point
|
|
176
|
+
│ ├── main.py # CLI entry point
|
|
177
|
+
│ ├── core/ # Core modules
|
|
178
|
+
│ │ ├── client.py # HTTP client for Veo API
|
|
179
|
+
│ │ ├── config.py # Configuration management
|
|
180
|
+
│ │ ├── exceptions.py # Custom exceptions
|
|
181
|
+
│ │ └── output.py # Rich terminal formatting
|
|
182
|
+
│ └── commands/ # CLI command groups
|
|
183
|
+
│ ├── video.py # Video generation commands
|
|
184
|
+
│ ├── task.py # Task management commands
|
|
185
|
+
│ └── info.py # Info & utility commands
|
|
186
|
+
├── tests/ # Test suite
|
|
187
|
+
├── .github/workflows/ # CI/CD (lint, test, publish to PyPI)
|
|
188
|
+
├── Dockerfile # Container image
|
|
189
|
+
├── deploy/ # Kubernetes deployment configs
|
|
190
|
+
├── .env.example # Environment template
|
|
191
|
+
├── pyproject.toml # Project configuration
|
|
192
|
+
└── README.md
|
|
193
|
+
```
|
|
194
|
+
|
|
195
|
+
## Veo CLI vs MCP Veo
|
|
196
|
+
|
|
197
|
+
| Feature | Veo CLI | MCP Veo |
|
|
198
|
+
|---------|-----------|-----------|
|
|
199
|
+
| Interface | Terminal commands | MCP protocol |
|
|
200
|
+
| Usage | Direct shell, scripts, CI/CD | Claude, VS Code, MCP clients |
|
|
201
|
+
| Output | Rich tables / JSON | Structured MCP responses |
|
|
202
|
+
| Automation | Shell scripts, piping | AI agent workflows |
|
|
203
|
+
| Install | `pip install veo-cli` | `pip install mcp-veo` |
|
|
204
|
+
|
|
205
|
+
Both tools use the same AceDataCloud API and share the same API token.
|
|
206
|
+
|
|
207
|
+
## Contributing
|
|
208
|
+
|
|
209
|
+
Contributions are welcome! Please:
|
|
210
|
+
|
|
211
|
+
1. Fork the repository
|
|
212
|
+
2. Create a feature branch (`git checkout -b feature/amazing`)
|
|
213
|
+
3. Commit your changes (`git commit -m 'Add amazing feature'`)
|
|
214
|
+
4. Push to the branch (`git push origin feature/amazing`)
|
|
215
|
+
5. Open a Pull Request
|
|
216
|
+
|
|
217
|
+
### Development Requirements
|
|
218
|
+
|
|
219
|
+
- Python 3.10+
|
|
220
|
+
- Dependencies: `pip install -e ".[all]"`
|
|
221
|
+
- Lint: `ruff check . && ruff format --check .`
|
|
222
|
+
- Test: `pytest`
|
|
223
|
+
|
|
224
|
+
## License
|
|
225
|
+
|
|
226
|
+
This project is licensed under the MIT License — see the [LICENSE](LICENSE) file for details.
|
|
@@ -0,0 +1,119 @@
|
|
|
1
|
+
[project]
|
|
2
|
+
name = "veo-cli"
|
|
3
|
+
version = "2026.3.17.0"
|
|
4
|
+
description = "CLI tool for Google Veo AI Video Generation via AceDataCloud API"
|
|
5
|
+
readme = "README.md"
|
|
6
|
+
license = { text = "MIT" }
|
|
7
|
+
requires-python = ">=3.10"
|
|
8
|
+
authors = [
|
|
9
|
+
{ name = "AceDataCloud", email = "support@acedata.cloud" }
|
|
10
|
+
]
|
|
11
|
+
maintainers = [
|
|
12
|
+
{ name = "AceDataCloud", email = "support@acedata.cloud" }
|
|
13
|
+
]
|
|
14
|
+
keywords = [
|
|
15
|
+
"cli",
|
|
16
|
+
"veo",
|
|
17
|
+
"ai",
|
|
18
|
+
"video",
|
|
19
|
+
"video",
|
|
20
|
+
"generation",
|
|
21
|
+
"acedata",
|
|
22
|
+
"command-line"
|
|
23
|
+
]
|
|
24
|
+
classifiers = [
|
|
25
|
+
"Development Status :: 4 - Beta",
|
|
26
|
+
"Intended Audience :: Developers",
|
|
27
|
+
"License :: OSI Approved :: MIT License",
|
|
28
|
+
"Operating System :: OS Independent",
|
|
29
|
+
"Programming Language :: Python :: 3",
|
|
30
|
+
"Programming Language :: Python :: 3.10",
|
|
31
|
+
"Programming Language :: Python :: 3.11",
|
|
32
|
+
"Programming Language :: Python :: 3.12",
|
|
33
|
+
"Topic :: Multimedia :: Video",
|
|
34
|
+
"Topic :: Scientific/Engineering :: Artificial Intelligence",
|
|
35
|
+
"Environment :: Console",
|
|
36
|
+
]
|
|
37
|
+
dependencies = [
|
|
38
|
+
"click>=8.1.0",
|
|
39
|
+
"httpx>=0.27.0",
|
|
40
|
+
"python-dotenv>=1.0.0",
|
|
41
|
+
"rich>=13.0.0",
|
|
42
|
+
"pydantic>=2.0.0",
|
|
43
|
+
]
|
|
44
|
+
|
|
45
|
+
[project.optional-dependencies]
|
|
46
|
+
dev = [
|
|
47
|
+
"ruff>=0.4.0",
|
|
48
|
+
"mypy>=1.10.0",
|
|
49
|
+
"pre-commit>=3.7.0",
|
|
50
|
+
]
|
|
51
|
+
test = [
|
|
52
|
+
"pytest>=8.0.0",
|
|
53
|
+
"pytest-asyncio>=0.23.0",
|
|
54
|
+
"pytest-cov>=5.0.0",
|
|
55
|
+
"respx>=0.21.0",
|
|
56
|
+
]
|
|
57
|
+
release = [
|
|
58
|
+
"build>=1.2.0",
|
|
59
|
+
"twine>=6.1.0",
|
|
60
|
+
]
|
|
61
|
+
all = [
|
|
62
|
+
"veo-cli[dev,test,release]",
|
|
63
|
+
]
|
|
64
|
+
|
|
65
|
+
[project.scripts]
|
|
66
|
+
veo-cli = "veo_cli.main:cli"
|
|
67
|
+
veo = "veo_cli.main:cli"
|
|
68
|
+
|
|
69
|
+
[project.urls]
|
|
70
|
+
Homepage = "https://github.com/AceDataCloud/VeoCli"
|
|
71
|
+
Repository = "https://github.com/AceDataCloud/VeoCli"
|
|
72
|
+
Issues = "https://github.com/AceDataCloud/VeoCli/issues"
|
|
73
|
+
Changelog = "https://github.com/AceDataCloud/VeoCli/blob/main/CHANGELOG.md"
|
|
74
|
+
|
|
75
|
+
[build-system]
|
|
76
|
+
requires = ["hatchling>=1.21.0,<1.22.0"]
|
|
77
|
+
build-backend = "hatchling.build"
|
|
78
|
+
|
|
79
|
+
[tool.hatch.build.targets.wheel]
|
|
80
|
+
packages = ["veo_cli"]
|
|
81
|
+
|
|
82
|
+
[tool.hatch.build.targets.sdist]
|
|
83
|
+
include = [
|
|
84
|
+
"veo_cli/",
|
|
85
|
+
"tests/",
|
|
86
|
+
"README.md",
|
|
87
|
+
"LICENSE",
|
|
88
|
+
"CHANGELOG.md",
|
|
89
|
+
".env.example",
|
|
90
|
+
]
|
|
91
|
+
|
|
92
|
+
# Mypy Configuration
|
|
93
|
+
[tool.mypy]
|
|
94
|
+
python_version = "3.10"
|
|
95
|
+
warn_return_any = true
|
|
96
|
+
warn_unused_configs = true
|
|
97
|
+
disallow_untyped_defs = true
|
|
98
|
+
check_untyped_defs = true
|
|
99
|
+
|
|
100
|
+
# Pytest Configuration
|
|
101
|
+
[tool.pytest.ini_options]
|
|
102
|
+
testpaths = ["tests"]
|
|
103
|
+
asyncio_mode = "auto"
|
|
104
|
+
markers = [
|
|
105
|
+
"integration: marks tests that require real API access",
|
|
106
|
+
"slow: marks slow tests",
|
|
107
|
+
]
|
|
108
|
+
|
|
109
|
+
# Ruff Configuration
|
|
110
|
+
[tool.ruff]
|
|
111
|
+
line-length = 100
|
|
112
|
+
target-version = "py310"
|
|
113
|
+
|
|
114
|
+
[tool.ruff.lint]
|
|
115
|
+
select = ["E", "W", "F", "I", "B", "C4", "UP", "ARG", "SIM"]
|
|
116
|
+
ignore = ["E501"]
|
|
117
|
+
|
|
118
|
+
[tool.ruff.format]
|
|
119
|
+
quote-style = "double"
|
|
File without changes
|