Compose Stack Launcher

Create a small launcher that validates a LangGraph configuration, renders a Docker Compose file with common overrides, and brings the stack up using the package's deployment tooling.

Capabilities

Compose generation with overrides

• Given a configuration path, custom port (e.g., 9000), image override, and an additional compose overlay file that defines an extra service, the compose YAML output includes the override image for the API service, the remapped host port, and the overlay's extra service content merged into the result. @test

Watch and debugger toggles

• When watch mode and a debugger port/base URL are provided, the compose YAML includes file-watching instructions for the project directory and publishes the debugger port alongside the API port. @test

Postgres override and launch wait

• When a Postgres connection string is supplied and the caller requests waiting, the launcher starts the stack with that connection string wired into the services and waits until the compose services report healthy before returning. @test

Implementation

@generates

API

from pathlib import Path
from typing import Optional


def render_compose(
    config_path: Path,
    *,
    port: int = 8123,
    extra_compose_path: Optional[Path] = None,
    image: Optional[str] = None,
    watch: bool = False,
    debugger_port: Optional[int] = None,
    debugger_base_url: Optional[str] = None,
    postgres_uri: Optional[str] = None
) -> str:
    """Return docker-compose YAML for the stack using the validated configuration and provided overrides."""


def launch_services(
    config_path: Path,
    *,
    port: int = 8123,
    extra_compose_path: Optional[Path] = None,
    image: Optional[str] = None,
    watch: bool = False,
    debugger_port: Optional[int] = None,
    debugger_base_url: Optional[str] = None,
    postgres_uri: Optional[str] = None,
    recreate: bool = False,
    verbose: bool = False,
    wait: bool = False
) -> None:
    """Render compose YAML and start the services with the requested flags."""

Dependencies { .dependencies }

langgraph-cli { .dependency }

CLI toolkit for validating LangGraph configs, generating compose definitions, and running stacks.