composio-videogen 2.5.3__tar.gz

composio_videogen-2.5.3/.gitignore

@@ -0,0 +1,8 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+build/
+dist/
+.venv/
+.venv-test/
+.pytest_cache/

composio_videogen-2.5.3/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2026 VideoGen
+
+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.

composio_videogen-2.5.3/PKG-INFO

@@ -0,0 +1,125 @@
+Metadata-Version: 2.5
+Name: composio-videogen
+Version: 2.5.3
+Summary: Official Composio custom toolkit for the VideoGen API. Generate videos, images, voiceovers, sound effects, music, and avatars from any Composio agent.
+Project-URL: Homepage, https://videogen.io
+Project-URL: Documentation, https://github.com/video-gen/video-workflow-recipes/tree/main/integrations/composio-videogen#readme
+Project-URL: Repository, https://github.com/video-gen/video-workflow-recipes
+License: MIT
+License-File: LICENSE
+Keywords: agents,ai,ai-video-generation,composio,image-generation,text-to-speech,text-to-video,tools,videogen
+Requires-Python: <3.16,>=3.11
+Requires-Dist: composio<0.31,>=0.30.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: videogen>=2.5.3
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# composio-videogen
+
+Official [Composio](https://composio.dev) custom toolkit for the [VideoGen API](https://docs.videogen.io). Give any Composio agent the ability to turn a script into a finished narrated video, plus generate standalone images, video clips, voiceovers, sound effects, music, and talking-head avatars.
+
+Every tool wraps the official [`videogen`](https://pypi.org/project/videogen/) SDK and runs as the team that owns your API key.
+
+## Install
+
+Requires Python 3.11–3.15 and Composio 0.30.x.
+
+```bash
+pip install composio-videogen
+```
+
+## Setup
+
+Get an API key from [app.videogen.io/api](https://app.videogen.io/api) and set it as `VIDEOGEN_API_KEY`:
+
+```bash
+export VIDEOGEN_API_KEY="your_api_key"
+```
+
+## Usage
+
+`create_videogen_toolkit()` returns a Composio custom toolkit. Pass it to a session via `experimental={"custom_toolkits": [...]}`, and `session.tools()` returns your VideoGen tools alongside any other Composio tools.
+
+```python
+from composio import Composio
+from composio_videogen import create_videogen_toolkit
+
+composio = Composio()
+videogen = create_videogen_toolkit(composio, include=["get_me", "list_files"])
+
+session = composio.create(
+    user_id="default",
+    experimental={"custom_toolkits": [videogen]},
+)
+
+tools = session.tools()
+```
+
+By default each tool blocks until the workflow or tool execution finishes and returns the completed result.
+
+## Options
+
+```python
+from videogen import VideoGen
+from composio_videogen import create_videogen_toolkit
+
+videogen = create_videogen_toolkit(
+    composio,
+
+    # Provide a pre-configured client, or pass api_key / base_url, or rely on env.
+    client=VideoGen(api_key="your_api_key"),
+
+    # Return the run/execution id immediately instead of waiting.
+    wait=False,
+
+    # Only register a subset of tools.
+    include=["script_to_video", "generate_image", "text_to_speech"],
+)
+```
+
+| Option | Default | Description |
+| --- | --- | --- |
+| `composio` | — | A `Composio` client. When provided, the toolkit is created via `composio.experimental.Toolkit`; otherwise the toolkit class is used directly. |
+| `client` | — | A pre-configured `VideoGen` client. |
+| `api_key` | `VIDEOGEN_API_KEY` | API key used to build a client when `client` is omitted. |
+| `base_url` | `VIDEOGEN_BASE_URL` or production | Override the API base URL. |
+| `wait` | `True` | Block until the operation finishes and return the result. |
+| `poll_interval_ms` | SDK default | Poll interval while waiting. |
+| `timeout_ms` | SDK default | Maximum time to wait before giving up. |
+| `include` | all tools | Restrict the registered tools to these tool names. |
+| `slug` | `VIDEOGEN` | Toolkit slug (final tool slugs are `LOCAL_<slug>_<TOOL>`). |
+| `name` | `VideoGen` | Human-readable toolkit name. |
+| `description` | VideoGen summary | Toolkit description shown to the agent. |
+| `preload` | `None` | When `True`, expose the toolkit's tools directly instead of via search. |
+
+## Tools
+
+<!-- BEGIN GENERATED PYTHON AGENT TOOLS -->
+- Workflows: `cancel_workflow_run`, `get_workflow_run`, `list_workflow_runs`, `prompt_to_video_clip`, `script_to_video`, `slideshow_to_video`, `storyboard_to_video`, `video_to_video`, `voiceover_to_video`.
+- Media generation: `cancel_tool_execution`, `generate_avatar`, `generate_image`, `generate_motion_graphic`, `generate_music`, `generate_sound_effect`, `generate_video_clip`, `get_tool_execution`, `image_3d_effect`, `list_tool_executions`, `remove_image_background`, `remove_video_background`, `text_to_speech`, `upscale_image`, `upscale_video`, `vectorize_image`.
+- Projects: `export_project`, `get_project`, `list_project_remix_actions`, `list_projects`, `remix_project`.
+- Files: `get_file`, `list_files`, `upload_file`.
+- Resources and account: `get_me`, `list_languages`, `list_tts_voices`.
+
+Avatar generation and supported video workflows use reusable actor entities. Pass `actor_entity_id` and set `avatar_quality` to `LOW`, `STANDARD`, `HIGH`, or `MAX`. Narrator changes are passed in `remix_actions` as `CHANGE_NARRATOR` action dictionaries.
+<!-- END GENERATED PYTHON AGENT TOOLS -->
+
+## Documentation
+
+- [Use with AI agents](https://docs.videogen.io/use-with-ai-agents)
+- [MCP server](https://docs.videogen.io/libraries/mcp)
+- [API reference](https://docs.videogen.io)
+
+## License
+
+MIT
+
+## Account and permissions
+
+Generation and editing use VideoGen credits. Obtain user approval before credit-consuming operations and expose only the tools the agent needs with `include`. The example above exposes only account and file-list tools. API keys belong in server-side environment variables. Upload tools send the selected local file to VideoGen; Composio receives tool definitions when you attach the toolkit to a session.
+
+Tested with Composio 0.30.0 and VideoGen SDK 2.5.3 using offline discovery and in-memory HTTP routing/polling checks. A real hosted Composio session and paid media generation are not part of these checks.
+
+[VideoGen](https://videogen.io/) · [MCP setup](https://videogen.io/videogen-mcp) · [Source](https://github.com/video-gen/video-workflow-recipes/tree/main/integrations/composio-videogen)

composio_videogen-2.5.3/README.md

@@ -0,0 +1,107 @@
+# composio-videogen
+
+Official [Composio](https://composio.dev) custom toolkit for the [VideoGen API](https://docs.videogen.io). Give any Composio agent the ability to turn a script into a finished narrated video, plus generate standalone images, video clips, voiceovers, sound effects, music, and talking-head avatars.
+
+Every tool wraps the official [`videogen`](https://pypi.org/project/videogen/) SDK and runs as the team that owns your API key.
+
+## Install
+
+Requires Python 3.11–3.15 and Composio 0.30.x.
+
+```bash
+pip install composio-videogen
+```
+
+## Setup
+
+Get an API key from [app.videogen.io/api](https://app.videogen.io/api) and set it as `VIDEOGEN_API_KEY`:
+
+```bash
+export VIDEOGEN_API_KEY="your_api_key"
+```
+
+## Usage
+
+`create_videogen_toolkit()` returns a Composio custom toolkit. Pass it to a session via `experimental={"custom_toolkits": [...]}`, and `session.tools()` returns your VideoGen tools alongside any other Composio tools.
+
+```python
+from composio import Composio
+from composio_videogen import create_videogen_toolkit
+
+composio = Composio()
+videogen = create_videogen_toolkit(composio, include=["get_me", "list_files"])
+
+session = composio.create(
+    user_id="default",
+    experimental={"custom_toolkits": [videogen]},
+)
+
+tools = session.tools()
+```
+
+By default each tool blocks until the workflow or tool execution finishes and returns the completed result.
+
+## Options
+
+```python
+from videogen import VideoGen
+from composio_videogen import create_videogen_toolkit
+
+videogen = create_videogen_toolkit(
+    composio,
+
+    # Provide a pre-configured client, or pass api_key / base_url, or rely on env.
+    client=VideoGen(api_key="your_api_key"),
+
+    # Return the run/execution id immediately instead of waiting.
+    wait=False,
+
+    # Only register a subset of tools.
+    include=["script_to_video", "generate_image", "text_to_speech"],
+)
+```
+
+| Option | Default | Description |
+| --- | --- | --- |
+| `composio` | — | A `Composio` client. When provided, the toolkit is created via `composio.experimental.Toolkit`; otherwise the toolkit class is used directly. |
+| `client` | — | A pre-configured `VideoGen` client. |
+| `api_key` | `VIDEOGEN_API_KEY` | API key used to build a client when `client` is omitted. |
+| `base_url` | `VIDEOGEN_BASE_URL` or production | Override the API base URL. |
+| `wait` | `True` | Block until the operation finishes and return the result. |
+| `poll_interval_ms` | SDK default | Poll interval while waiting. |
+| `timeout_ms` | SDK default | Maximum time to wait before giving up. |
+| `include` | all tools | Restrict the registered tools to these tool names. |
+| `slug` | `VIDEOGEN` | Toolkit slug (final tool slugs are `LOCAL_<slug>_<TOOL>`). |
+| `name` | `VideoGen` | Human-readable toolkit name. |
+| `description` | VideoGen summary | Toolkit description shown to the agent. |
+| `preload` | `None` | When `True`, expose the toolkit's tools directly instead of via search. |
+
+## Tools
+
+<!-- BEGIN GENERATED PYTHON AGENT TOOLS -->
+- Workflows: `cancel_workflow_run`, `get_workflow_run`, `list_workflow_runs`, `prompt_to_video_clip`, `script_to_video`, `slideshow_to_video`, `storyboard_to_video`, `video_to_video`, `voiceover_to_video`.
+- Media generation: `cancel_tool_execution`, `generate_avatar`, `generate_image`, `generate_motion_graphic`, `generate_music`, `generate_sound_effect`, `generate_video_clip`, `get_tool_execution`, `image_3d_effect`, `list_tool_executions`, `remove_image_background`, `remove_video_background`, `text_to_speech`, `upscale_image`, `upscale_video`, `vectorize_image`.
+- Projects: `export_project`, `get_project`, `list_project_remix_actions`, `list_projects`, `remix_project`.
+- Files: `get_file`, `list_files`, `upload_file`.
+- Resources and account: `get_me`, `list_languages`, `list_tts_voices`.
+
+Avatar generation and supported video workflows use reusable actor entities. Pass `actor_entity_id` and set `avatar_quality` to `LOW`, `STANDARD`, `HIGH`, or `MAX`. Narrator changes are passed in `remix_actions` as `CHANGE_NARRATOR` action dictionaries.
+<!-- END GENERATED PYTHON AGENT TOOLS -->
+
+## Documentation
+
+- [Use with AI agents](https://docs.videogen.io/use-with-ai-agents)
+- [MCP server](https://docs.videogen.io/libraries/mcp)
+- [API reference](https://docs.videogen.io)
+
+## License
+
+MIT
+
+## Account and permissions
+
+Generation and editing use VideoGen credits. Obtain user approval before credit-consuming operations and expose only the tools the agent needs with `include`. The example above exposes only account and file-list tools. API keys belong in server-side environment variables. Upload tools send the selected local file to VideoGen; Composio receives tool definitions when you attach the toolkit to a session.
+
+Tested with Composio 0.30.0 and VideoGen SDK 2.5.3 using offline discovery and in-memory HTTP routing/polling checks. A real hosted Composio session and paid media generation are not part of these checks.
+
+[VideoGen](https://videogen.io/) · [MCP setup](https://videogen.io/videogen-mcp) · [Source](https://github.com/video-gen/video-workflow-recipes/tree/main/integrations/composio-videogen)

composio_videogen-2.5.3/pyproject.toml

@@ -0,0 +1,45 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "composio-videogen"
+version = "2.5.3"
+description = "Official Composio custom toolkit for the VideoGen API. Generate videos, images, voiceovers, sound effects, music, and avatars from any Composio agent."
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.11,<3.16"
+keywords = [
+    "videogen",
+    "composio",
+    "ai",
+    "agents",
+    "tools",
+    "text-to-video",
+    "ai-video-generation",
+    "text-to-speech",
+    "image-generation",
+]
+
+dependencies = [
+    "videogen>=2.5.3",
+    "composio>=0.30.0,<0.31",
+    "pydantic>=2.0.0",
+]
+
+[project.urls]
+Homepage = "https://videogen.io"
+Documentation = "https://github.com/video-gen/video-workflow-recipes/tree/main/integrations/composio-videogen#readme"
+Repository = "https://github.com/video-gen/video-workflow-recipes"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/composio_videogen"]
+
+[project.optional-dependencies]
+dev = ["pytest>=8.0.0"]
+
+[tool.pytest.ini_options]
+markers = [
+    "integration: live tests that call the VideoGen API (require VIDEOGEN_API_KEY)",
+]
+testpaths = ["tests"]

composio_videogen-2.5.3/src/composio_videogen/__init__.py

@@ -0,0 +1,20 @@
+"""Official Composio custom toolkit for the VideoGen API."""
+
+from importlib.metadata import PackageNotFoundError, version
+
+from .client import resolve_client
+from .operations import Controls
+from .toolkit import create_videogen_toolkit
+from .tools import register_videogen_tools
+
+__all__ = [
+    "Controls",
+    "create_videogen_toolkit",
+    "register_videogen_tools",
+    "resolve_client",
+]
+
+try:
+    __version__ = version("composio-videogen")
+except PackageNotFoundError:
+    __version__ = "0.0.0"

composio_videogen-2.5.3/src/composio_videogen/client.py

@@ -0,0 +1,47 @@
+# AUTO-GENERATED from api/integrations/python-agent-templates/client.py. DO NOT EDIT.
+"""Client resolution for the VideoGen Composio integration."""
+
+from __future__ import annotations
+
+import os
+from typing import Optional
+
+from videogen import VideoGen
+
+_DEFAULT_BASE_URL = "https://api.videogen.io"
+
+
+def resolve_client(
+    client: Optional[VideoGen] = None,
+    *,
+    api_key: Optional[str] = None,
+    base_url: Optional[str] = None,
+) -> VideoGen:
+    """Resolve a VideoGen client from an explicit client, an explicit key, or the environment.
+
+    Every tool call is authenticated as the team that owns the key.
+
+    Args:
+        client: A pre-configured ``VideoGen`` client. Used as-is when provided.
+        api_key: API key. Falls back to the ``VIDEOGEN_API_KEY`` environment variable.
+        base_url: API base URL. Falls back to ``VIDEOGEN_BASE_URL``, then production.
+    """
+    if client is not None:
+        return client
+
+    resolved_key = api_key or os.environ.get("VIDEOGEN_API_KEY")
+
+    if resolved_key is None or resolved_key.strip() == "":
+        raise ValueError(
+            "No VideoGen API key found. Pass `client` or `api_key`, or set the "
+            "VIDEOGEN_API_KEY environment variable. Create a key at "
+            "https://app.videogen.io/api."
+        )
+
+    resolved_base_url = base_url or os.environ.get("VIDEOGEN_BASE_URL") or _DEFAULT_BASE_URL
+
+    return VideoGen(
+        api_key=resolved_key.strip(),
+        base_url=resolved_base_url,
+        client_id="composio",
+    )

composio_videogen-2.5.3/src/composio_videogen/operations.py

@@ -0,0 +1,88 @@
+# AUTO-GENERATED from api/integrations/python-agent-templates/operations.py. DO NOT EDIT.
+"""Shared helpers for starting and polling VideoGen operations."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Any, Callable, Dict, Optional
+
+from videogen import VideoGen
+from videogen.poll_executed_tool import poll_executed_tool
+from videogen.poll_project_export import poll_project_export
+from videogen.poll_workflow_run import poll_workflow_run
+
+
+@dataclass
+class Controls:
+    """How the tools handle asynchronous VideoGen operations."""
+
+    wait: bool = True
+    poll_interval_ms: Optional[int] = None
+    timeout_ms: Optional[int] = None
+
+
+def to_dict(obj: Any) -> Any:
+    """Convert an SDK response model into a plain, JSON-serializable structure."""
+    model_dump = getattr(obj, "model_dump", None)
+    if callable(model_dump):
+        return model_dump(mode="json")
+    return obj
+
+
+def drop_none(values: Dict[str, Any]) -> Dict[str, Any]:
+    """Drop ``None``-valued keys so the SDK applies its own defaults."""
+    return {key: value for key, value in values.items() if value is not None}
+
+
+def _poll_kwargs(controls: Controls) -> Dict[str, int]:
+    kwargs: Dict[str, int] = {}
+    if controls.poll_interval_ms is not None:
+        kwargs["poll_interval_ms"] = controls.poll_interval_ms
+    if controls.timeout_ms is not None:
+        kwargs["timeout_ms"] = controls.timeout_ms
+    return kwargs
+
+
+def run_workflow(
+    client: VideoGen,
+    controls: Controls,
+    start: Callable[[], Any],
+) -> Any:
+    """Start a workflow and, unless ``wait`` is False, poll it to a terminal state."""
+    started = start()
+    if not controls.wait:
+        return to_dict(started)
+
+    run = poll_workflow_run(client, started["workflow_run_id"], **_poll_kwargs(controls))
+    return to_dict(run)
+
+
+def run_tool(
+    client: VideoGen,
+    controls: Controls,
+    start: Callable[[], Any],
+) -> Any:
+    """Start a media tool execution and, unless ``wait`` is False, poll it to a terminal state."""
+    started = start()
+    if not controls.wait:
+        return to_dict(started)
+
+    execution = poll_executed_tool(client, started["tool_execution_id"], **_poll_kwargs(controls))
+    return to_dict(execution)
+
+
+def run_export(
+    client: VideoGen,
+    controls: Controls,
+    project_id: str,
+    start: Callable[[], Any],
+) -> Any:
+    """Start a project export and, unless ``wait`` is False, poll until the download URL is ready."""
+    started = start()
+    if not controls.wait:
+        return to_dict(started)
+
+    project_export = poll_project_export(
+        client, project_id, started["export_id"], **_poll_kwargs(controls)
+    )
+    return to_dict(project_export)

composio_videogen-2.5.3/src/composio_videogen/toolkit.py

@@ -0,0 +1,89 @@
+"""Factory for the VideoGen Composio custom toolkit."""
+
+from __future__ import annotations
+
+from typing import Any, Iterable, Optional
+
+from videogen import VideoGen
+
+from .client import resolve_client
+from .operations import Controls
+from .tools import register_videogen_tools
+
+DEFAULT_TOOLKIT_SLUG = "VIDEOGEN"
+DEFAULT_TOOLKIT_NAME = "VideoGen"
+DEFAULT_TOOLKIT_DESCRIPTION = (
+    "Generate videos, images, voiceovers, sound effects, music, and talking-head "
+    "avatars with the VideoGen API."
+)
+
+
+def _new_toolkit(
+    composio: Optional[Any],
+    *,
+    slug: str,
+    name: str,
+    description: str,
+    preload: Optional[bool],
+) -> Any:
+    """Construct an empty Composio custom toolkit.
+
+    Uses ``composio.experimental.Toolkit`` when a client is provided, otherwise
+    falls back to the toolkit class directly so the package is usable without
+    first constructing a ``Composio`` client.
+    """
+    if composio is not None:
+        return composio.experimental.Toolkit(
+            slug=slug, name=name, description=description, preload=preload
+        )
+
+    from composio.core.models.custom_tool import ExperimentalToolkit
+
+    return ExperimentalToolkit(slug=slug, name=name, description=description, preload=preload)
+
+
+def create_videogen_toolkit(
+    composio: Optional[Any] = None,
+    *,
+    client: Optional[VideoGen] = None,
+    api_key: Optional[str] = None,
+    base_url: Optional[str] = None,
+    wait: bool = True,
+    poll_interval_ms: Optional[int] = None,
+    timeout_ms: Optional[int] = None,
+    include: Optional[Iterable[str]] = None,
+    slug: str = DEFAULT_TOOLKIT_SLUG,
+    name: str = DEFAULT_TOOLKIT_NAME,
+    description: str = DEFAULT_TOOLKIT_DESCRIPTION,
+    preload: Optional[bool] = None,
+) -> Any:
+    """Build a Composio custom toolkit exposing the full VideoGen tool set.
+
+    Pass the returned toolkit to ``composio.create(experimental={"custom_toolkits": [toolkit]})``.
+    ``session.tools()`` then includes every VideoGen tool alongside your other Composio tools.
+
+    Args:
+        composio: A ``Composio`` client. When provided, the toolkit is created via
+            ``composio.experimental.Toolkit``; otherwise the toolkit class is used directly.
+        client: A pre-configured ``VideoGen`` client. When omitted, one is built from
+            ``api_key`` / ``base_url`` or the ``VIDEOGEN_API_KEY`` environment variable.
+        wait: When True (default), tools block until the workflow run or tool execution
+            finishes and return the completed result. Set False to return immediately
+            with the run/execution id for the caller to poll.
+        poll_interval_ms: Poll interval while waiting. Defaults to the SDK's default.
+        timeout_ms: Maximum time to wait before giving up. Defaults to the SDK's default.
+        include: Restrict the registered tools to these tool names. Defaults to all tools.
+        slug: Toolkit slug (final tool slugs are ``LOCAL_<slug>_<TOOL>``).
+        name: Human-readable toolkit name.
+        description: Toolkit description shown to the agent.
+        preload: When True, expose the toolkit's tools directly instead of via search.
+    """
+    resolved_client = resolve_client(client, api_key=api_key, base_url=base_url)
+    controls = Controls(wait=wait, poll_interval_ms=poll_interval_ms, timeout_ms=timeout_ms)
+
+    toolkit = _new_toolkit(
+        composio, slug=slug, name=name, description=description, preload=preload
+    )
+    register_videogen_tools(toolkit, resolved_client, controls, include=include)
+
+    return toolkit