comfygit 0.3.22__tar.gz → 0.4.1__tar.gz

{comfygit-0.3.22 → comfygit-0.4.1}/PKG-INFO

@@ -1,14 +1,16 @@
 Metadata-Version: 2.4
 Name: comfygit
-Version: 0.3.22
+Version: 0.4.1
 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.22
+Requires-Dist: comfygit-core==0.4.1
+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.22 → comfygit-0.4.1}/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.22 → comfygit-0.4.1}/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")
@@ -220,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")
@@ -278,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")
@@ -297,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)
@@ -542,6 +620,91 @@ def _add_env_commands(subparsers: argparse._SubParsersAction) -> None:
     )
     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")
@@ -815,6 +978,37 @@ def _add_env_commands(subparsers: argparse._SubParsersAction) -> None:
     )
     node_add_parser.set_defaults(func=env_cmds.node_add)
 
+    # node dev-link
+    node_dev_link_parser = node_subparsers.add_parser(
+        "dev-link",
+        help="Link a tracked node to a local development checkout",
+    )
+    node_dev_link_parser.add_argument(
+        "node_name",
+        help="Existing node identifier/name, or identifier to use for a new dev node",
+    ).completer = installed_node_completer  # type: ignore[attr-defined]
+    node_dev_link_parser.add_argument(
+        "--path",
+        required=True,
+        type=Path,
+        help="Path to the local custom-node development checkout",
+    )
+    node_dev_link_parser.add_argument(
+        "--name",
+        help="custom_nodes directory/symlink name to use when no tracked node exists",
+    )
+    node_dev_link_parser.add_argument(
+        "--replace-existing",
+        action="store_true",
+        help="Archive an existing materialized node directory and replace it with a symlink",
+    )
+    node_dev_link_parser.add_argument(
+        "--force",
+        action="store_true",
+        help="Allow replacing an existing mismatched symlink or directory",
+    )
+    node_dev_link_parser.set_defaults(func=env_cmds.node_dev_link)
+
     # node remove
     node_remove_parser = node_subparsers.add_parser("remove", help="Remove custom node(s)")
     node_remove_parser.add_argument("node_names", nargs="+", help="Node registry ID(s) or name(s)").completer = installed_node_completer  # type: ignore[attr-defined]
@@ -867,6 +1061,65 @@ def _add_env_commands(subparsers: argparse._SubParsersAction) -> None:
     )
     workflow_importance_parser.set_defaults(func=_make_help_func(workflow_importance_parser))
 
+    model_list_parser = workflow_model_subparsers.add_parser(
+        "list",
+        help="List models declared for a workflow"
+    )
+    model_list_parser.add_argument(
+        "workflow_name",
+        nargs="?",
+        help="Workflow name (interactive if omitted)"
+    ).completer = workflow_completer  # type: ignore[attr-defined]
+    model_list_parser.set_defaults(func=env_cmds.workflow_model_list)
+
+    model_add_parser = workflow_model_subparsers.add_parser(
+        "add",
+        help="Declare an indexed local model as required by a workflow"
+    )
+    model_add_parser.add_argument(
+        "workflow_name",
+        help="Workflow name"
+    ).completer = workflow_completer  # type: ignore[attr-defined]
+    model_add_parser.add_argument(
+        "--hash",
+        dest="model_hash",
+        help="Indexed model hash to attach"
+    )
+    model_add_parser.add_argument(
+        "--path",
+        dest="relative_path",
+        help="Model path relative to the models directory, e.g. checkpoints/model.safetensors"
+    )
+    model_add_parser.add_argument(
+        "--importance",
+        "--criticality",
+        dest="importance",
+        default="required",
+        choices=["required", "flexible", "optional"],
+        help="Workflow dependency importance (default: required)"
+    )
+    model_add_parser.set_defaults(func=env_cmds.workflow_model_add)
+
+    model_remove_parser = workflow_model_subparsers.add_parser(
+        "remove",
+        help="Remove a manually declared workflow model"
+    )
+    model_remove_parser.add_argument(
+        "workflow_name",
+        help="Workflow name"
+    ).completer = workflow_completer  # type: ignore[attr-defined]
+    model_remove_parser.add_argument(
+        "--hash",
+        dest="model_hash",
+        help="Manual model hash to remove"
+    )
+    model_remove_parser.add_argument(
+        "--path",
+        dest="relative_path",
+        help="Manual model path relative to the models directory"
+    )
+    model_remove_parser.set_defaults(func=env_cmds.workflow_model_remove)
+
     importance_parser = workflow_model_subparsers.add_parser(
         "importance",
         help="Set model importance (required/flexible/optional)"