comfygit 0.3.20__tar.gz → 0.4.0__tar.gz

{comfygit-0.3.20 → comfygit-0.4.0}/PKG-INFO

@@ -1,14 +1,16 @@
 Metadata-Version: 2.4
 Name: comfygit
-Version: 0.3.20
+Version: 0.4.0
 Summary: ComfyGit - Git-based environment management for ComfyUI
 Project-URL: Documentation, https://docs.comfygit.org/
 Project-URL: Repository, https://github.com/comfygit-ai/comfygit
 Project-URL: Issues, https://github.com/comfygit-ai/comfygit/issues
 License-File: LICENSE.txt
 Requires-Python: >=3.10
+Requires-Dist: aiohttp>=3.13.4
 Requires-Dist: argcomplete>=3.5.0
-Requires-Dist: comfygit-core==0.3.20
+Requires-Dist: comfygit-core==0.4.0
+Requires-Dist: requests>=2.33.0
 Description-Content-Type: text/markdown
 
 # ComfyGit CLI
@@ -663,9 +665,10 @@ See [packages/core/README.md](../core/README.md) for core library documentation.
 
 ## Contributing
 
-This is a MVP project run by a single developer. Contributions welcome!
+This is a MVP project run by a single developer. Contributions welcome.
 
-**Note:** Contributors must sign our [Contributor License Agreement](../../CLA.md) to enable dual-licensing. See [CONTRIBUTING.md](../../CONTRIBUTING.md) for details.
+Contributions are licensed under the repository's GPL-3.0 license. See
+[CONTRIBUTING.md](../../CONTRIBUTING.md) for details.
 
 **Adding a new command:**
 1. Add command parser in `cli.py` (`_add_global_commands` or `_add_env_commands`)

{comfygit-0.3.20 → comfygit-0.4.0}/README.md

@@ -650,9 +650,10 @@ See [packages/core/README.md](../core/README.md) for core library documentation.
 
 ## Contributing
 
-This is a MVP project run by a single developer. Contributions welcome!
+This is a MVP project run by a single developer. Contributions welcome.
 
-**Note:** Contributors must sign our [Contributor License Agreement](../../CLA.md) to enable dual-licensing. See [CONTRIBUTING.md](../../CONTRIBUTING.md) for details.
+Contributions are licensed under the repository's GPL-3.0 license. See
+[CONTRIBUTING.md](../../CONTRIBUTING.md) for details.
 
 **Adding a new command:**
 1. Add command parser in `cli.py` (`_add_global_commands` or `_add_env_commands`)

{comfygit-0.3.20 → comfygit-0.4.0}/comfygit_cli/cli.py

@@ -179,6 +179,42 @@ def _add_global_commands(subparsers: argparse._SubParsersAction) -> None:
     list_parser = subparsers.add_parser("list", help="List all environments")
     list_parser.set_defaults(func=global_cmds.list_envs)
 
+    # analyze - Analyze a workflow file without requiring workspace/env
+    analyze_parser = subparsers.add_parser(
+        "analyze",
+        help="Analyze a workflow file for dependencies",
+    )
+    analyze_parser.add_argument("workflow", type=Path, help="Path to workflow JSON file")
+    analyze_parser.add_argument(
+        "--json",
+        action="store_true",
+        dest="json_output",
+        help="Output as JSON",
+    )
+    analyze_parser.add_argument(
+        "--draft-spec",
+        action="store_true",
+        help="Output draft pyproject.toml",
+    )
+    analyze_parser.add_argument(
+        "--online",
+        action="store_true",
+        help="Enrich model sources using online provider lookups",
+    )
+    analyze_parser.add_argument(
+        "--verbose",
+        "-v",
+        action="store_true",
+        help="Show detailed provenance",
+    )
+    analyze_parser.add_argument(
+        "--quiet",
+        "-q",
+        action="store_true",
+        help="Only show unresolved items",
+    )
+    analyze_parser.set_defaults(func=global_cmds.analyze)
+
     # update - Update ComfyGit CLI (self-update)
     update_parser = subparsers.add_parser("update", help="Update ComfyGit CLI")
     update_parser.add_argument("--check", action="store_true", help="Check for updates without upgrading")
@@ -206,6 +242,11 @@ def _add_global_commands(subparsers: argparse._SubParsersAction) -> None:
             "Default: auto"
         ),
     )
+    import_parser.add_argument(
+        "--no-manager",
+        action="store_true",
+        help="Skip comfygit-manager installation (headless/API-only mode)",
+    )
     import_parser.add_argument("--use", action="store_true", help="Set imported environment as active")
     import_parser.add_argument(
         "--models",
@@ -215,6 +256,41 @@ def _add_global_commands(subparsers: argparse._SubParsersAction) -> None:
     import_parser.add_argument("-y", "--yes", action="store_true", help="Skip confirmation prompts, use defaults for workspace initialization")
     import_parser.set_defaults(func=global_cmds.import_env)
 
+    # materialize - Hydrate a portable environment for headless runtime/build use
+    materialize_parser = subparsers.add_parser(
+        "materialize",
+        help="Materialize a ComfyGit environment from a directory, tarball, or git URL",
+    )
+    materialize_parser.add_argument("source", type=str, help="Source directory, .tar.gz bundle, or git repository URL")
+    materialize_parser.add_argument("--name", type=str, required=True, help="Name for the materialized environment")
+    materialize_parser.add_argument("--workspace", type=Path, help="Workspace path to create/use")
+    materialize_parser.add_argument("--models-dir", type=Path, help="Global model directory for the workspace")
+    materialize_parser.add_argument("--branch", "-b", type=str, help="Git branch, tag, or commit to materialize")
+    materialize_parser.add_argument(
+        "--torch-backend",
+        default="auto",
+        metavar="BACKEND",
+        help=(
+            "PyTorch backend. Examples: auto (detect GPU), cpu, "
+            "cu128 (CUDA 12.8), cu126, cu124, rocm6.3 (AMD), xpu (Intel). "
+            "Default: auto"
+        ),
+    )
+    materialize_parser.add_argument(
+        "--models",
+        choices=["all", "required", "skip"],
+        default="skip",
+        help="Model download strategy. Default: skip",
+    )
+    materialize_parser.add_argument(
+        "--with-manager",
+        action="store_true",
+        help="Install/register comfygit-manager during materialization",
+    )
+    materialize_parser.add_argument("--use", action="store_true", help="Set materialized environment as active")
+    materialize_parser.add_argument("--replace", action="store_true", help="Replace an existing environment with the same name")
+    materialize_parser.set_defaults(func=global_cmds.materialize_env)
+
     # export - Export ComfyGit environment
     export_parser = subparsers.add_parser("export", help="Export ComfyGit environment (include relevant files from .cec)")
     export_parser.add_argument("path", type=Path, nargs="?", help="Path to output file")
@@ -273,6 +349,12 @@ def _add_global_commands(subparsers: argparse._SubParsersAction) -> None:
     model_add_source_parser.add_argument("url", nargs="?", help="Download URL")
     model_add_source_parser.set_defaults(func=global_cmds.model_add_source)
 
+    # model delete
+    model_delete_parser = model_subparsers.add_parser("delete", help="Delete model files and clean index entries")
+    model_delete_parser.add_argument("identifier", help="Model hash, hash prefix, filename, or path")
+    model_delete_parser.add_argument("-y", "--yes", action="store_true", help="Skip confirmation prompt")
+    model_delete_parser.set_defaults(func=global_cmds.model_delete)
+
     # Registry management subcommands
     registry_parser = subparsers.add_parser("registry", help="Manage node registry cache")
     registry_subparsers = registry_parser.add_subparsers(dest="registry_command", help="Registry commands")
@@ -292,6 +374,7 @@ def _add_global_commands(subparsers: argparse._SubParsersAction) -> None:
 
     # Legacy flags - still supported at root level for backward compatibility
     config_parser.add_argument("--civitai-key", type=str, help="Set Civitai API key (use empty string to clear)")
+    config_parser.add_argument("--github-token", type=str, help="Set GitHub token for private git repository access (use empty string to clear)")
     config_parser.add_argument("--uv-cache", type=str, help="Set external UV cache path (use empty string to clear)")
     config_parser.add_argument("--show", action="store_true", help="Show current configuration")
     config_parser.set_defaults(func=global_cmds.config)
@@ -405,6 +488,11 @@ def _add_env_commands(subparsers: argparse._SubParsersAction) -> None:
             "Default: auto"
         ),
     )
+    create_parser.add_argument(
+        "--no-manager",
+        action="store_true",
+        help="Skip comfygit-manager installation (headless/API-only mode)",
+    )
     create_parser.add_argument("--use", action="store_true", help="Set active environment after creation")
     create_parser.add_argument("-y", "--yes", action="store_true", help="Skip confirmation prompts, use defaults for workspace initialization")
     create_parser.set_defaults(func=env_cmds.create)
@@ -445,47 +533,6 @@ def _add_env_commands(subparsers: argparse._SubParsersAction) -> None:
     env_config_torch_detect_parser = env_config_torch_subparsers.add_parser("detect", help="Auto-detect and show recommended backend")
     env_config_torch_detect_parser.set_defaults(func=env_cmds.env_config_torch_detect)
 
-    # env-config local-sources - Manage local UV sources for this environment
-    env_config_local_sources_parser = env_config_subparsers.add_parser(
-        "local-sources",
-        help="Manage local UV source overrides"
-    )
-    env_config_local_sources_subparsers = env_config_local_sources_parser.add_subparsers(
-        dest="local_sources_command",
-        help="Local source commands"
-    )
-    env_config_local_sources_parser.set_defaults(func=_make_help_func(env_config_local_sources_parser))
-
-    # env-config local-sources show
-    env_config_local_sources_show_parser = env_config_local_sources_subparsers.add_parser(
-        "show", help="Show local UV sources"
-    )
-    env_config_local_sources_show_parser.set_defaults(func=env_cmds.env_config_local_sources_show)
-
-    # env-config local-sources add <package> --path PATH [--editable]
-    env_config_local_sources_add_parser = env_config_local_sources_subparsers.add_parser(
-        "add", help="Add or update a local UV source"
-    )
-    env_config_local_sources_add_parser.add_argument("package", help="Package name to override")
-    env_config_local_sources_add_parser.add_argument(
-        "--path",
-        required=True,
-        help="Local path to package (absolute or relative)"
-    )
-    env_config_local_sources_add_parser.add_argument(
-        "--editable",
-        action="store_true",
-        help="Install as editable"
-    )
-    env_config_local_sources_add_parser.set_defaults(func=env_cmds.env_config_local_sources_add)
-
-    # env-config local-sources remove <package>
-    env_config_local_sources_remove_parser = env_config_local_sources_subparsers.add_parser(
-        "remove", help="Remove a local UV source"
-    )
-    env_config_local_sources_remove_parser.add_argument("package", help="Package name to remove")
-    env_config_local_sources_remove_parser.set_defaults(func=env_cmds.env_config_local_sources_remove)
-
     # env-config extras - Manage default optional extras for sync
     env_config_extras_parser = env_config_subparsers.add_parser(
         "extras",
@@ -517,6 +564,32 @@ def _add_env_commands(subparsers: argparse._SubParsersAction) -> None:
     env_config_extras_remove_parser.add_argument("extras", nargs="+", help="Extra name(s) to remove")
     env_config_extras_remove_parser.set_defaults(func=env_cmds.env_config_extras_remove)
 
+    # overlay - Manage overlays for this environment
+    overlay_parser = subparsers.add_parser("overlay", help="Manage dependency overlays")
+    overlay_subparsers = overlay_parser.add_subparsers(dest="overlay_command", help="Overlay commands")
+    overlay_parser.set_defaults(func=_make_help_func(overlay_parser))
+
+    overlay_list_parser = overlay_subparsers.add_parser("list", help="List available overlays")
+    overlay_list_parser.add_argument("--active", action="store_true", help="Show only active overlays")
+    overlay_list_parser.set_defaults(func=env_cmds.overlay_list)
+
+    overlay_show_parser = overlay_subparsers.add_parser("show", help="Show overlay file contents")
+    overlay_show_parser.add_argument("name", help="Overlay name")
+    overlay_show_parser.set_defaults(func=env_cmds.overlay_show)
+
+    overlay_enable_parser = overlay_subparsers.add_parser("enable", help="Enable overlay for this machine")
+    overlay_enable_parser.add_argument("name", help="Overlay name")
+    overlay_enable_parser.set_defaults(func=env_cmds.overlay_enable)
+
+    overlay_disable_parser = overlay_subparsers.add_parser("disable", help="Disable overlay for this machine")
+    overlay_disable_parser.add_argument("name", help="Overlay name")
+    overlay_disable_parser.set_defaults(func=env_cmds.overlay_disable)
+
+    overlay_create_parser = overlay_subparsers.add_parser("create", help="Create overlay template")
+    overlay_create_parser.add_argument("name", nargs="?", default=None, help="Overlay name")
+    overlay_create_parser.add_argument("--local", action="store_true", help="Create a local (gitignored) overlay")
+    overlay_create_parser.set_defaults(func=env_cmds.overlay_create)
+
     # run - Run ComfyUI (special handling for ComfyUI args)
     run_parser = subparsers.add_parser("run", help="Run ComfyUI")
     run_parser.add_argument("--no-sync", action="store_true", help="Skip environment sync before running")
@@ -540,8 +613,98 @@ def _add_env_commands(subparsers: argparse._SubParsersAction) -> None:
         action="store_true",
         help="Install all optional dependency extras"
     )
+    run_parser.add_argument(
+        "--overlay",
+        action="append",
+        help="Apply overlay for this run sync (can be repeated)",
+    )
     run_parser.set_defaults(func=env_cmds.run, args=[])
 
+    # serve - Front a running ComfyUI instance with contract-shaped endpoints
+    serve_parser = subparsers.add_parser(
+        "serve",
+        help="Serve workflow contracts for this environment",
+    )
+    serve_parser.add_argument(
+        "--host",
+        default="127.0.0.1",
+        help="Host/interface to bind (default: 127.0.0.1)",
+    )
+    serve_parser.add_argument(
+        "--port",
+        type=int,
+        default=8190,
+        help="Port to bind (default: 8190)",
+    )
+    serve_parser.add_argument(
+        "--comfy-url",
+        default="http://127.0.0.1:8188",
+        help="Running ComfyUI API URL (default: http://127.0.0.1:8188)",
+    )
+    serve_parser.add_argument(
+        "--role",
+        choices=["studio", "proxy"],
+        default="studio",
+        help="Serve role: studio front door or compute-only proxy runtime (default: studio)",
+    )
+    serve_parser.add_argument(
+        "--executor",
+        choices=["local", "proxy"],
+        default="local",
+        help="Execution adapter for studio role (default: local)",
+    )
+    serve_parser.add_argument(
+        "--proxy-url",
+        help="Proxy runtime base URL when --executor proxy is used",
+    )
+    serve_parser.add_argument(
+        "--proxy-token",
+        help="Bearer token shared by proxy front door and proxy runtime",
+    )
+    serve_parser.add_argument(
+        "--callback-url",
+        help="Browser/coordinator-reachable base URL that proxy workers call back after async runs",
+    )
+    serve_parser.add_argument(
+        "--callback-token",
+        help="Bearer token accepted by the front door worker-callback endpoint (defaults to --proxy-token)",
+    )
+    serve_parser.add_argument(
+        "--artifact-dir",
+        type=Path,
+        help="Directory for localized proxy artifacts (default: <workspace>/.metadata/serve/artifacts)",
+    )
+    serve_parser.add_argument(
+        "--max-request-mb",
+        type=int,
+        default=256,
+        help="Maximum contract request body size in MiB (default: 256)",
+    )
+    serve_parser.add_argument(
+        "--run-timeout-seconds",
+        type=float,
+        default=12 * 60 * 60,
+        help="Maximum background run wait time in seconds (default: 43200)",
+    )
+    serve_parser.add_argument(
+        "--state",
+        choices=["ephemeral", "local"],
+        default="ephemeral",
+        help="Serve runtime state adapter (default: ephemeral)",
+    )
+    serve_parser.add_argument(
+        "--gallery",
+        choices=["private", "shared"],
+        default="private",
+        help="Gallery visibility policy for serve state (default: private)",
+    )
+    serve_parser.add_argument(
+        "--state-db",
+        type=Path,
+        help="SQLite database path for --state local (default: <workspace>/.metadata/serve/serve.sqlite)",
+    )
+    serve_parser.set_defaults(func=env_cmds.serve)
+
     # status - Show environment status
     status_parser = subparsers.add_parser("status", help="Show status (both sync and git status)")
     status_parser.add_argument("-v", "--verbose", action="store_true", help="Show full details")
@@ -599,6 +762,11 @@ def _add_env_commands(subparsers: argparse._SubParsersAction) -> None:
         action="store_true",
         help="Install all optional dependency extras"
     )
+    sync_parser.add_argument(
+        "--overlay",
+        action="append",
+        help="Apply overlay for this sync only (can be repeated)",
+    )
     sync_parser.add_argument(
         "-v", "--verbose",
         action="store_true",
@@ -793,6 +961,11 @@ def _add_env_commands(subparsers: argparse._SubParsersAction) -> None:
     node_add_parser.add_argument("--force", action="store_true", help="Force overwrite existing directory")
     node_add_parser.add_argument("--verbose", "-v", action="store_true", help="Show full UV error output for dependency conflicts")
     node_add_parser.add_argument("--strict", action="store_true", help="Fail on dependency conflicts instead of auto-resolving")
+    node_add_parser.add_argument(
+        "--resolve-with-overlays",
+        action="store_true",
+        help="Resolve node install with all active overlays (default is pytorch-only)",
+    )
     node_add_parser.add_argument(
         "--extra",
         action="append",