0.1.7

Author: frontboat

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "veotools"
-version = "0.1.6"
+version = "0.1.7"
 description = "A Python toolkit for AI-powered video generation and seamless stitching using Google's Veo models."
 readme = "readme.md"
 requires-python = ">=3.10"
@@ -54,4 +54,5 @@ mcp = ["mcp[cli]>=1.0.0"]
 
 [project.scripts]
 veo = "veotools.cli:main"
+veo-mcp = "veotools.mcp_server:main"
 

readme.md

@@ -158,6 +158,41 @@ status = veo.generate_get(job_id)
 veo.generate_cancel(job_id)
 ```
 
+### Cursor MCP configuration
+
+Add an entry in `~/.cursor/mcp.json` pointing to the installed `veo-mcp` (or your venv path):
+
+```json
+{
+  "mcpServers": {
+    "veotools": {
+      "command": "/Users/you/.venv/bin/veo-mcp",
+      "args": [],
+      "env": {
+        "GEMINI_API_KEY": "your-api-key",
+        "VEO_OUTPUT_DIR": "/Users/you/projects/output" 
+      },
+      "disabled": false
+    }
+  }
+}
+```
+
+Alternatively, use Python directly:
+
+```json
+{
+  "mcpServers": {
+    "veotools": {
+      "command": "/Users/you/.venv/bin/python",
+      "args": ["-m", "veotools.mcp_server"],
+      "env": { "GEMINI_API_KEY": "your-api-key" },
+      "disabled": false
+    }
+  }
+}
+```
+
 ## Model discovery
 ```python
 models = veotools.list_models(include_remote=True)

veotools/__init__.py

@@ -35,7 +35,7 @@
     generate_cancel,
 )
 
-__version__ = "0.1.6"
+__version__ = "0.1.7"
 
 __all__ = [
     "VeoClient",

veotools/cli.py

@@ -49,11 +49,18 @@ def cmd_generate(ns: argparse.Namespace) -> int:
     kwargs: Dict[str, Any] = {}
     if ns.model:
         kwargs["model"] = ns.model
+    if ns.aspect_ratio:
+        kwargs["aspect_ratio"] = ns.aspect_ratio
+    if ns.negative_prompt:
+        kwargs["negative_prompt"] = ns.negative_prompt
+    if ns.person_generation:
+        kwargs["person_generation"] = ns.person_generation
     if ns.image:
         result = veo.generate_from_image(
             image_path=Path(ns.image),
             prompt=ns.prompt,
             on_progress=_print_progress,
+            **kwargs,
         )
     elif ns.video:
         result = veo.generate_from_video(
@@ -79,12 +86,21 @@ def cmd_generate(ns: argparse.Namespace) -> int:
 def cmd_continue(ns: argparse.Namespace) -> int:
     veo.init()
     # Generate continuation
+    kwargs: Dict[str, Any] = {}
+    if ns.model:
+        kwargs["model"] = ns.model
+    if ns.aspect_ratio:
+        kwargs["aspect_ratio"] = ns.aspect_ratio
+    if ns.negative_prompt:
+        kwargs["negative_prompt"] = ns.negative_prompt
+    if ns.person_generation:
+        kwargs["person_generation"] = ns.person_generation
     gen = veo.generate_from_video(
         video_path=Path(ns.video),
         prompt=ns.prompt,
         extract_at=ns.extract_at,
-        model=ns.model,
         on_progress=_print_progress,
+        **kwargs,
     )
     # Stitch with original
     stitched = veo.stitch_videos([Path(ns.video), Path(gen.path)], overlap=ns.overlap)
@@ -117,6 +133,9 @@ def build_parser() -> argparse.ArgumentParser:
     s.add_argument("--image", help="Path to input image")
     s.add_argument("--video", help="Path to input video")
     s.add_argument("--extract-at", type=float, default=-1.0, help="Time offset for video continuation")
+    s.add_argument("--aspect-ratio", choices=["16:9","9:16"], help="Requested aspect ratio (model-dependent)")
+    s.add_argument("--negative-prompt", help="Text to avoid in generation")
+    s.add_argument("--person-generation", choices=["allow_all","allow_adult","dont_allow"], help="Person generation policy (model/region dependent)")
     s.add_argument("--json", action="store_true", help="Output JSON")
     s.set_defaults(func=cmd_generate)
 
@@ -126,6 +145,9 @@ def build_parser() -> argparse.ArgumentParser:
     s.add_argument("--model", help="Model ID")
     s.add_argument("--extract-at", type=float, default=-1.0)
     s.add_argument("--overlap", type=float, default=1.0)
+    s.add_argument("--aspect-ratio", choices=["16:9","9:16"], help="Requested aspect ratio (model-dependent)")
+    s.add_argument("--negative-prompt", help="Text to avoid in generation")
+    s.add_argument("--person-generation", choices=["allow_all","allow_adult","dont_allow"], help="Person generation policy (model/region dependent)")
     s.add_argument("--json", action="store_true")
     s.set_defaults(func=cmd_continue)
 

veotools/core.py

@@ -119,6 +119,7 @@ class ModelConfig:
             "supports_duration": False,
             "supports_enhance": False,
             "supports_fps": False,
+            "supports_aspect_ratio": True,
             "supports_audio": True,
             "default_duration": 8,
             "generation_time": 60
@@ -128,6 +129,7 @@ class ModelConfig:
             "supports_duration": False,
             "supports_enhance": False,
             "supports_fps": False,
+            "supports_aspect_ratio": True,
             "supports_audio": True,
             "default_duration": 8,
             "generation_time": 120
@@ -137,6 +139,7 @@ class ModelConfig:
             "supports_duration": True,
             "supports_enhance": True,
             "supports_fps": True,
+            "supports_aspect_ratio": True,
             "supports_audio": False,
             "default_duration": 5,
             "generation_time": 180
@@ -166,5 +169,27 @@ def build_generation_config(cls, model: str, **kwargs) -> types.GenerateVideosCo
 
         if config["supports_fps"] and "fps" in kwargs:
             params["fps"] = kwargs["fps"]
+
+        # Aspect ratio (e.g., "16:9"; Veo 3 limited to 16:9; Veo 2 supports 16:9 and 9:16)
+        if config.get("supports_aspect_ratio") and "aspect_ratio" in kwargs and kwargs["aspect_ratio"]:
+            ar = str(kwargs["aspect_ratio"])  # normalize
+            model_key = model.replace("models/", "")
+            if model_key.startswith("veo-3.0"):
+                allowed = {"16:9"}
+            elif model_key.startswith("veo-2.0"):
+                allowed = {"16:9", "9:16"}
+            else:
+                allowed = {"16:9"}
+            if ar not in allowed:
+                raise ValueError(f"aspect_ratio '{ar}' not supported for model '{model_key}'. Allowed: {sorted(allowed)}")
+            params["aspect_ratio"] = ar
+
+        # Docs-backed pass-throughs
+        if "negative_prompt" in kwargs and kwargs["negative_prompt"]:
+            params["negative_prompt"] = kwargs["negative_prompt"]
+
+        if "person_generation" in kwargs and kwargs["person_generation"]:
+            # Person generation options vary by model/region; pass through as provided
+            params["person_generation"] = kwargs["person_generation"]
 
         return types.GenerateVideosConfig(**params)