github/spec-kit · error · BundlerError

Network access disabled; cannot fetch catalog '{source.id}'

Error message

Network access disabled; cannot fetch catalog '{source.id}' from {url}.

What it means

Error "Network access disabled; cannot fetch catalog '{source.id}' from {url}." thrown in github/spec-kit.

Source

Thrown at src/specify_cli/bundler/services/adapters.py:158

            if payload is None:
                raise BundlerError(f"Unknown built-in catalog '{url}'.")
            return payload

        if scheme == "file":
            path = _file_url_to_path(parsed)
            if not path.exists():
                raise BundlerError(f"Catalog file not found: {path}")
            return load_json(path)

        if scheme == "" or _is_windows_drive_path(url):
            path = Path(url)
            if not path.exists():
                raise BundlerError(f"Catalog file not found: {path}")
            return load_json(path)

        if scheme in ("http", "https"):
            if not allow_network:
                raise BundlerError(
                    f"Network access disabled; cannot fetch catalog '{source.id}' "
                    f"from {url}."
                )
            _validate_remote_url(source.id, url)
            return _http_get_json(source.id, url)

        raise BundlerError(f"Unsupported catalog URL scheme: {url}")

    return fetch


def _http_get_json(source_id: str, url: str) -> dict:
    """Fetch catalog JSON over HTTP(S) via the shared authenticated client.

    Routing through :func:`specify_cli.authentication.http.open_url` gives
    ``auth.json`` token support and strips the ``Authorization`` header when a
    redirect leaves the entry's trusted hosts or downgrades the scheme. We also
    reject any redirect that leaves HTTPS (the ``redirect_validator`` runs

View on GitHub (pinned to bf88c9f9a8)

Solutions

1. Re-run without --offline/--no-network so the remote catalog can be fetched, or add a local/bundled catalog source.

When it happens

Trigger: Thrown at src/specify_cli/bundler/services/adapters.py:158 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of github/spec-kit@bf88c9f9a8 (2026-08-14). Data as JSON: /api/errors/824377d8f1ec4f36. Report an issue: GitHub.