Unable to install CLI as wheel access is blocked by corp policy

[sujitdmello]

Is there a manual / local way of installing the CLI or the Agents? I am able to clone the repo but cannot build it locally or install the CLI. uv sync and uv tool install both fail with blocked requests for wheels. This is fairly common in Enterprise settings.

[mnriem]

Does https://github.com/github/spec-kit?tab=readme-ov-file#option-2-one-time-usage work for you?

[sujitdmello]

Unfortunately, similar 403 issue.

error: Failed to fetch: (https://files.pythonhosted.org/packages/98/78/01c019cdb5d6498122777c1a43056ebb3ebfeef2076d9d026bfe15583b2b/click-8.3.1-py3-none-any.whl.metadata%60)
Caused by: HTTP status client error (403 Forbidden) for url (https://files.pythonhosted.org/packages/98/78/01c019cdb5d6498122777c1a43056ebb3ebfeef2076d9d026bfe15583b2b/click-8.3.1-py3-none-any.whl.metadata)

[mnriem]

On a machine with PyPI access (same OS/architecture as the target machine):

1. Clone the repo

git clone https://github.com/github/spec-kit.git
cd spec-kit

2. Download all wheels into a vendor directory

mkdir vendor
pip download -d vendor . --no-cache-dir

3. Zip it up for transfer

zip -r spec-kit-offline.zip . -x '.git/*'

On the constrained machine:

4. Unzip

unzip spec-kit-offline.zip -d spec-kit
cd spec-kit

5. Install with no network access required

pip install --no-index --find-links=./vendor .

6. Verify it works

specify --help
specify check

Notes:

• Python 3.11+ is required on the target machine.
• Step 2 downloads platform-specific wheels, so the machine running pip download should match the target OS and Python version. If they differ, use pip download -d vendor . --platform <platform> --python-version 3.11 --only-binary=:all:.
• The vendor/ directory will be ~5–10 MB (typer, click, rich, httpx, etc.).
• To upgrade later, repeat steps 1–3 with the latest clone and re-run step 5 with --force-reinstall.

Could you try this and let us know if it works in your environment?

[sujitdmello]

Tried this on a couple of laptops, one constrained and one not. The wheel download step works, but the offline install command fails in both cases:

[mnriem]

Can you copy and paste it as text please?

[sujitdmello]

Sorry should have done that first:

C:\Users\K199940\repos\spec-kit>pip install --no-index --find-links=./vendor .
Looking in links: ./vendor
Processing c:\users\k199940\repos\spec-kit
  Installing build dependencies ... error
  error: subprocess-exited-with-error
  × pip subprocess to install build dependencies did not run successfully.
  │ exit code: 1

  ╰─> [3 lines of output]
      Looking in links: ./vendor
      ERROR: Could not find a version that satisfies the requirement hatchling (from versions: none)
      ERROR: No matching distribution found for hatchling
      [end of output]
  note: This error originates from a subprocess, and is likely not a problem with pip.
error: subprocess-exited-with-error
× pip subprocess to install build dependencies did not run successfully.
│ exit code: 1
╰─> See above for output.
note: This error originates from a subprocess, and is likely not a problem with pip.
C:\Users\K199940\repos\spec-kit>

[mnriem]

We have filed #1711 to work through the air-gapped / offline scenario. Please stay tuned!