You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit ba2edba
Browse filesBrowse the repository at this point in the historyBrowse files
Bundle templates, commands, and scripts inside the specify-cli wheel so
that `specify init` works without any network access by default.
Changes:
- pyproject.toml: add hatchling force-include for core_pack assets; bump
version to 0.2.1
- __init__.py: add _locate_core_pack(), _generate_agent_commands() (Python
port of generate_commands() shell function), and scaffold_from_core_pack();
modify init() to scaffold from bundled assets by default; add --from-github
flag to opt back in to the GitHub download path
- release.yml: build wheel during CI release job
- create-github-release.sh: attach .whl as a release asset
- docs/installation.md: add Enterprise/Air-Gapped Installation section
- README.md: add Option 3 enterprise install with accurate offline story
Closesgithub#1711
Addresses github#1752
If your environment blocks PyPI access, download the pre-built `specify_cli-*.whl` wheel from the [releases page](https://github.com/github/spec-kit/releases/latest) and install it directly:
103
+
104
+
```bash
105
+
pip install specify_cli-*.whl
106
+
specify init my-project --ai claude # works fully offline — no api.github.com needed
107
+
```
108
+
109
+
The wheel bundles all templates, commands, and scripts, so `specify init` works without any network access after install. See the [Enterprise / Air-Gapped Installation](./docs/installation.md#enterprise--air-gapped-installation) section for fully offline (no-PyPI) instructions.
110
+
100
111
### 2. Establish project principles
101
112
102
113
Launch your AI assistant in the project directory. Most agents expose spec-kit as `/speckit.*` slash commands; Codex CLI in skills mode uses `$speckit-*` instead.
Copy file name to clipboardExpand all lines: docs/installation.md
+44Lines changed: 44 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -75,6 +75,50 @@ The `.specify/scripts` directory will contain both `.sh` and `.ps1` scripts.
75
75
76
76
## Troubleshooting
77
77
78
+
### Enterprise / Air-Gapped Installation
79
+
80
+
If your environment blocks access to PyPI (you see 403 errors when running `uv tool install` or `pip install`), you can install Specify using the pre-built wheel from the GitHub releases page.
81
+
82
+
**Step 1: Download the wheel**
83
+
84
+
Go to the [Spec Kit releases page](https://github.com/github/spec-kit/releases/latest) and download the `specify_cli-*.whl` file.
85
+
86
+
**Step 2: Install the wheel**
87
+
88
+
```bash
89
+
pip install specify_cli-*.whl
90
+
```
91
+
92
+
**Step 3: Initialize a project (no network required)**
93
+
94
+
```bash
95
+
specify init my-project --ai claude
96
+
```
97
+
98
+
The CLI bundles all templates, commands, and scripts inside the wheel, so `specify init` works completely offline — no connection to `api.github.com` needed.
99
+
100
+
**If you also need runtime dependencies offline** (fully air-gapped machines with no access to any PyPI), use a connected machine with the same OS and Python version to download them first:
101
+
102
+
```bash
103
+
# On a connected machine (same OS and Python version as the target):
104
+
pip download -d vendor specify_cli-*.whl
105
+
106
+
# Transfer the wheel and vendor/ directory to the target machine
0 commit comments