add onedir

Author: navedmerchant

.github/workflows/build.yml

@@ -50,37 +50,81 @@ jobs:
       - name: Install dependencies
         run: uv sync --extra mcp
 
-      - name: Build executable
+      - name: Build onefile executable
         run: uv run python build.py --name semble --with-mcp
 
-      - name: Smoke test (Unix)
+      - name: Rename onefile artifact (Unix)
+        if: runner.os != 'Windows'
+        run: mv dist/semble dist/${{ matrix.artifact }}
+
+      - name: Rename onefile artifact (Windows)
+        if: runner.os == 'Windows'
+        run: mv dist/semble.exe dist/${{ matrix.artifact }}
+
+      - name: Build onedir executable
+        run: uv run python build.py --onedir --name semble --with-mcp
+
+      - name: Smoke test onefile (Unix)
         if: runner.os != 'Windows'
         run: |
-          chmod +x dist/semble
-          ./dist/semble search --help
-          ./dist/semble init --help
+          chmod +x dist/${{ matrix.artifact }}
+          ./dist/${{ matrix.artifact }} search --help
+          ./dist/${{ matrix.artifact }} init --help
 
-      - name: Smoke test (Windows)
+      - name: Smoke test onefile (Windows)
         if: runner.os == 'Windows'
         run: |
-          dist\semble.exe search --help
-          dist\semble.exe init --help
+          dist\${{ matrix.artifact }} search --help
+          dist\${{ matrix.artifact }} init --help
 
-      - name: Rename artifact (Unix)
+      - name: Smoke test onedir (Unix)
         if: runner.os != 'Windows'
-        run: mv dist/semble dist/${{ matrix.artifact }}
+        run: |
+          chmod +x dist/semble/semble
+          ./dist/semble/semble search --help
+          ./dist/semble/semble init --help
 
-      - name: Rename artifact (Windows)
+      - name: Smoke test onedir (Windows)
         if: runner.os == 'Windows'
-        run: mv dist/semble.exe dist/${{ matrix.artifact }}
+        run: |
+          dist\semble\semble.exe search --help
+          dist\semble\semble.exe init --help
+
+      - name: Package onedir as archive (Unix)
+        if: runner.os != 'Windows'
+        run: |
+          cd dist/semble
+          tar -czf ../semble-${{ matrix.target }}-fast.tar.gz .
 
-      - name: Upload artifact
+      - name: Package onedir as archive (Windows)
+        if: runner.os == 'Windows'
+        run: |
+          cd dist/semble
+          Compress-Archive -Path * -DestinationPath ../semble-${{ matrix.target }}-fast.zip
+
+      - name: Upload onefile artifact
         uses: actions/upload-artifact@v4
         with:
           name: ${{ matrix.artifact }}
           path: dist/${{ matrix.artifact }}
           retention-days: 30
 
+      - name: Upload onedir artifact (Unix)
+        if: runner.os != 'Windows'
+        uses: actions/upload-artifact@v4
+        with:
+          name: semble-${{ matrix.target }}-fast.tar.gz
+          path: dist/semble-${{ matrix.target }}-fast.tar.gz
+          retention-days: 30
+
+      - name: Upload onedir artifact (Windows)
+        if: runner.os == 'Windows'
+        uses: actions/upload-artifact@v4
+        with:
+          name: semble-${{ matrix.target }}-fast.zip
+          path: dist/semble-${{ matrix.target }}-fast.zip
+          retention-days: 30
+
   integration-test:
     needs: [build]
     runs-on: ubuntu-22.04
@@ -163,19 +207,38 @@ jobs:
 
             No Python installation required. Download the binary for your platform and run it directly.
 
+            ### Single-file binaries (portable, slower startup)
+
             | Platform | Architecture | File |
             |----------|-------------|------|
             | Linux | x64 | `semble-linux-x64` |
             | Linux | ARM64 | `semble-linux-arm64` |
             | macOS | Apple Silicon (ARM64) | `semble-macos-arm64` |
             | Windows | x64 | `semble-windows-x64.exe` |
 
+            ### Fast-start archives (extract and run, ~20x faster startup)
+
+            | Platform | Architecture | File |
+            |----------|-------------|------|
+            | Linux | x64 | `semble-linux-x64-fast.tar.gz` |
+            | Linux | ARM64 | `semble-linux-arm64-fast.tar.gz` |
+            | macOS | Apple Silicon (ARM64) | `semble-macos-arm64-fast.tar.gz` |
+            | Windows | x64 | `semble-windows-x64-fast.zip` |
+
             ### Usage
+
+            **Single-file (portable):**
             ```bash
-            chmod +x semble-*
+            chmod +x semble-linux-x64
             ./semble-linux-x64 search "authentication flow" ./my-project
             ```
 
+            **Fast-start (recommended for repeated use):**
+            ```bash
+            tar -xzf semble-linux-x64-fast.tar.gz -C semble/
+            ./semble/semble search "authentication flow" ./my-project
+            ```
+
             ### Verify checksums
             ```bash
             sha256sum -c checksums-sha256.txt

README.md

@@ -4,12 +4,16 @@ Packages [semble](https://github.com/MinishLab/semble) into standalone executabl
 
 ## Platforms
 
-| Platform | Architecture | Artifact |
-|----------|-------------|----------|
-| Linux | x64 | `semble-linux-x64` |
-| Linux | ARM64 | `semble-linux-arm64` |
-| macOS | Apple Silicon (ARM64) | `semble-macos-arm64` |
-| Windows | x64 | `semble-windows-x64.exe` |
+| Platform | Architecture | Single-file | Fast-start archive |
+|----------|-------------|-------------|-------------------|
+| Linux | x64 | `semble-linux-x64` | `semble-linux-x64-fast.tar.gz` |
+| Linux | ARM64 | `semble-linux-arm64` | `semble-linux-arm64-fast.tar.gz` |
+| macOS | Apple Silicon (ARM64) | `semble-macos-arm64` | `semble-macos-arm64-fast.tar.gz` |
+| Windows | x64 | `semble-windows-x64.exe` | `semble-windows-x64-fast.zip` |
+
+**Single-file** — one portable binary, no extraction needed. Slower startup (~6s) due to decompression on each run.
+
+**Fast-start** — a compressed archive containing the binary + pre-extracted dependencies. ~20x faster startup, recommended for repeated use or MCP server mode.
 
 ## Download
 
@@ -20,20 +24,22 @@ Grab the latest binary from the [Releases](../../releases) page, or download the
 The executable works exactly like the `semble` CLI:
 
 ```bash
-# Make it executable (Linux/macOS)
+# Single-file: make it executable and run (Linux/macOS)
 chmod +x semble-macos-arm64
-
-# Search a local repo
 ./semble-macos-arm64 search "authentication flow" ./my-project
 
+# Fast-start: extract and run
+tar -xzf semble-macos-arm64-fast.tar.gz -C semble/
+./semble/semble search "authentication flow" ./my-project
+
 # Search a remote repo
 ./semble-macos-arm64 search "save model" https://github.com/MinishLab/model2vec
 
 # Find related code
 ./semble-macos-arm64 find-related src/auth.py 42 ./my-project
 
-# Run as MCP server
-./semble-macos-arm64
+# Run as MCP server (fast-start recommended)
+./semble/semble
 ```
 
 ## Building Locally