Staging

.github/workflows/ci.yml.disabled

@@ -0,0 +1,49 @@
+name: CI
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+      - dev
+      - "V*"
+
+jobs:
+  lint:
+    name: Lint (ruff)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.10"
+          cache: pip
+
+      - name: Install ruff
+        run: pip install ruff
+
+      - name: Check formatting
+        run: ruff format --check .
+
+      - name: Run ruff check
+        run: ruff check .
+
+  smoke:
+    name: Smoke (syntax + imports)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.10"
+          cache: pip
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt
+
+      - name: Byte-compile source tree
+        run: python -m compileall -q app agent_core agents decorators skills

.github/workflows/release.yml

@@ -100,11 +100,31 @@ jobs:
         with:
           python-version: "3.10"
 
+      - name: Install Linux webview system packages
+        if: matrix.os_label == 'linux'
+        shell: bash
+        run: |
+          # PyGObject builds against these headers. WebKitGTK + the
+          # webkit2-4.0 GObject introspection bindings are what pywebview's
+          # GTK backend talks to at runtime. End users need the runtime
+          # halves of these too (libwebkit2gtk-4.0-37, gir1.2-webkit2-4.0).
+          sudo apt-get update
+          sudo apt-get install -y \
+            libwebkit2gtk-4.0-37 \
+            gir1.2-webkit2-4.0 \
+            libgirepository1.0-dev \
+            libcairo2-dev \
+            python3-gi \
+            python3-gi-cairo
+
       - name: Install dependencies
         shell: bash
         run: |
           python -m pip install --upgrade pip
           pip install -r requirements.txt
+          # Installer-only deps (pywebview + per-OS backend bindings). Kept
+          # in a separate file so the agent's requirements.txt stays lean.
+          pip install -r packaging/requirements-installer.txt
           pip install pyinstaller
 
       - name: Set up Node.js
@@ -126,61 +146,55 @@ jobs:
         run: |
           echo "{\"use_conda\": false, \"gui_mode_enabled\": false}" > config.json
 
-      - name: Build with PyInstaller
+      - name: Write VERSION file from git tag
+        shell: bash
+        run: |
+          # github.ref_name is "v1.3.0" for tag pushes; strip the leading 'v'.
+          # The installer's _read_bundled_version() reads this to pin the
+          # download URL to the matching agent release.
+          REF="${{ github.ref_name }}"
+          VERSION="${REF#v}"
+          echo "$VERSION" > VERSION
+          echo "VERSION file content: $(cat VERSION)"
+
+      - name: Build agent (CraftBotAgent) with PyInstaller
+        shell: bash
+        run: pyinstaller --noconfirm --clean packaging/CraftBotAgent.spec
+
+      - name: Zip agent payload
         shell: bash
         run: |
-          pyinstaller \
-            --noconfirm \
-            --clean \
-            --onefile \
-            --name CraftBot \
-            --collect-submodules app \
-            --collect-submodules agent_core \
-            --collect-submodules agents \
-            --collect-submodules decorators \
-            --collect-submodules chromadb \
-            --hidden-import onnxruntime \
-            --hidden-import tokenizers \
-            --collect-data tiktoken_ext \
-            --collect-submodules tiktoken \
-            --exclude-module torch \
-            --exclude-module torchvision \
-            --exclude-module torchaudio \
-            --exclude-module triton \
-            --exclude-module nvidia \
-            --exclude-module transformers \
-            --exclude-module cv2 \
-            --exclude-module matplotlib \
-            --exclude-module tensorflow \
-            --additional-hooks-dir hooks \
-            --runtime-hook rthooks/rthook-rich-unicode.py \
-            --add-data "assets${{ matrix.data_sep }}assets" \
-            --add-data "main.py${{ matrix.data_sep }}." \
-            --add-data "config.json${{ matrix.data_sep }}." \
-            --add-data ".env.example${{ matrix.data_sep }}." \
-            --add-data "requirements.txt${{ matrix.data_sep }}." \
-            --add-data "environment.yml${{ matrix.data_sep }}." \
-            --add-data "app/config${{ matrix.data_sep }}app/config" \
-            --add-data "app/data${{ matrix.data_sep }}app/data" \
-            --add-data "app/ui_layer/browser/frontend/dist${{ matrix.data_sep }}app/ui_layer/browser/frontend/dist" \
-            --add-data "app/gui/docker-compose.yaml${{ matrix.data_sep }}app/gui" \
-            --add-data "app/gui/Dockerfile${{ matrix.data_sep }}app/gui" \
-            --add-data "app/gui/custom-cont-init.d${{ matrix.data_sep }}app/gui/custom-cont-init.d" \
-            --add-data "agents${{ matrix.data_sep }}agents" \
-            --add-data "skills${{ matrix.data_sep }}skills" \
-            run.py
-
-      - name: Rename artifact
+          # CraftBotAgent.spec produces dist/CraftBotAgent/ (folder).
+          # Zip it into the asset name the installer downloads at runtime.
+          cd dist
+          if [ "${{ matrix.os_label }}" = "windows" ]; then
+            7z a -tzip "CraftBot-agent-${{ matrix.os_label }}.zip" CraftBotAgent
+          else
+            zip -r "CraftBot-agent-${{ matrix.os_label }}.zip" CraftBotAgent
+          fi
+          ls -lh "CraftBot-agent-${{ matrix.os_label }}.zip"
+
+      - name: Build installer (CraftBotInstaller) with PyInstaller
+        shell: bash
+        run: pyinstaller --noconfirm --clean packaging/CraftBotInstaller.spec
+
+      - name: Rename installer artifact
         shell: bash
         run: |
-          mv "dist/CraftBot${{ matrix.ext }}" \
-             "dist/CraftBot-${{ matrix.os_label }}${{ matrix.ext }}"
+          mv "dist/CraftBotInstaller${{ matrix.ext }}" \
+             "dist/CraftBotInstaller-${{ matrix.os_label }}${{ matrix.ext }}"
+
+      - name: Upload installer artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: release-installer-${{ matrix.os_label }}
+          path: dist/CraftBotInstaller-${{ matrix.os_label }}${{ matrix.ext }}
 
-      - name: Upload artifact
+      - name: Upload agent zip artifact
         uses: actions/upload-artifact@v4
         with:
-          name: release-${{ matrix.os_label }}
-          path: dist/CraftBot-${{ matrix.os_label }}${{ matrix.ext }}
+          name: release-agent-${{ matrix.os_label }}
+          path: dist/CraftBot-agent-${{ matrix.os_label }}.zip
 
   # ──────────────────────────────────────────────
   # Create GitHub Release with all artifacts
@@ -202,21 +216,14 @@ jobs:
           files: release/**
           generate_release_notes: true
           body: |
-            ## Installation
-
-            ### Docker Compose (Recommended)
-            Includes the agent, OmniParser, and GUI desktop VM — all in one.
-            ```bash
-            git clone https://github.com/zfoong/CraftBot.git
-            cd CraftBot
-            cp .env.example .env   # Edit with your API keys
-            docker compose up
-            ```
-            For GPU acceleration on OmniParser:
-            ```bash
-            docker compose -f docker-compose.yml -f docker-compose.gpu.yml up
-            ```
-
-            ### Standalone Binary
-            Download the binary for your platform from the assets below.
-            Requires Docker for GUI mode and Omniparser. Run with `--no-omniparser` to skip OmniParser setup. Run with `--no-conda` to skip conda setup and use system Python instead.
+            ### Installer (Recommended)
+            Download `CraftBotInstaller-<platform>` from the assets below and
+            run it. The installer wizard will let you choose an install
+            location and will download the matching agent payload
+            (`CraftBot-agent-<platform>.zip`) from this same release.
+
+            ### Manual install
+            If you'd rather skip the wizard, download both
+            `CraftBotInstaller-<platform>` and `CraftBot-agent-<platform>.zip`,
+            place them in the same folder, and run the installer — it'll find
+            the local zip instead of fetching from GitHub.

.github/workflows/staging-lint.yml

@@ -0,0 +1,42 @@
+name: Staging Lint
+
+on:
+  push:
+    branches: [staging]
+  pull_request:
+    branches: [staging]
+
+jobs:
+  ruff:
+    name: Ruff (format + check)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.10"
+          cache: pip
+
+      - name: Install ruff
+        run: pip install ruff
+
+      - name: Check formatting
+        run: ruff format --check .
+
+      - name: Run ruff check
+        run: ruff check .
+
+  smoke:
+    name: Smoke (syntax + imports)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.10"
+          cache: pip
+
+      - name: Byte-compile source tree
+        run: python -m compileall -q app agent_core agents decorators skills

.gitignore

@@ -30,7 +30,14 @@ build/
 debug_images
 .vscode/
 .idea/
+# PyInstaller auto-generates a <name>.spec when run without one — those are
+# build artifacts. Our hand-written CraftBotInstaller.spec and
+# CraftBotAgent.spec live under packaging/ and are source-of-truth for the
+# release workflow, so they MUST be tracked. Keep the broad ignore but
+# allow-list the two we own.
 *.spec
+!packaging/CraftBotInstaller.spec
+!packaging/CraftBotAgent.spec
 **/.whatsapp_web_sessions/
 **/build
 **/build_*
@@ -46,4 +53,6 @@ app/config/settings.json
 **/USER.md
 **/onboarding_config.json
 **/config.json
-!build_template.py
+!build_template.py
+docs/LIVING_UI_DEVELOPER_GUIDE.md
+agent_file_system/ACTIONS.md

CONTRIBUTING.md

@@ -9,7 +9,7 @@ To ensure contributor feels welcome, we have this guide to help you get started
 ## 🌟 Links
 
 - [Discord Community](https://discord.gg/W8jdMKdE)  
-- [Issue Tracker](https://github.com/zfoong/CraftBot/issues)
+- [Issue Tracker](https://github.com/CraftOS-dev/CraftBot/issues)
 
 ## 1. 🚀 Ways to Contribute
 
@@ -24,7 +24,7 @@ Here are all the things you to contribute to the community.
 ## 📫 There are several ways to collaborate with the team and community:
 
 ### GitHub Collaboration
-- [Open an issue](https://github.com/zfoong/CraftBot/issues) for bug reports, feature requests, or discussions
+- [Open an issue](https://github.com/CraftOS-dev/CraftBot/issues) for bug reports, feature requests, or discussions
 - Submit pull requests to contribute code or documentation
 - Join ongoing discussions in existing issues and PRs
 
@@ -45,7 +45,7 @@ For faster responses, consider using our Discord channel where the whole communi
 
 ### Fork and Clone
 
-1. Fork the [**CraftBot**](https://github.com/zfoong/CraftBot) repository
+1. Fork the [**CraftBot**](https://github.com/CraftOS-dev/CraftBot) repository
 2. Clone your fork:
 ```shell
 git clone https://github.com/<your-github-username>/CraftBot.git
@@ -85,7 +85,7 @@ git push origin your-branch-name
 ```
 
 2. Create a Pull Request:
-   - Go to the [**CraftBot** repository](https://github.com/zfoong/CraftBot)
+   - Go to the [**CraftBot** repository](https://github.com/CraftOS-dev/CraftBot)
    - Click "Compare & Pull Request" and open a PR against dev branch
    - Fill in the PR template with details about your changes
 
@@ -99,7 +99,7 @@ git push origin your-branch-name
 
 ## 6. 📫 To Get Help
 
-- Open an [issue](https://github.com/zfoong/CraftBot)
+- Open an [issue](https://github.com/CraftOS-dev/CraftBot)
 - Join our Discord community
 
 Thank you for contributing to **CraftBot**! 🌟

Dockerfile

@@ -1,7 +1,9 @@
 FROM python:3.10-slim
 
 ENV PYTHONDONTWRITEBYTECODE=1 \
-    PYTHONUNBUFFERED=1
+    PYTHONUNBUFFERED=1 \
+    PIP_TIMEOUT=600 \
+    PIP_PROGRESS_BAR=off
 
 RUN apt-get update \
     && apt-get install -y --no-install-recommends \
@@ -38,7 +40,7 @@ WORKDIR /app
 COPY requirements.txt ./requirements.txt
 
 RUN pip install --no-cache-dir --upgrade pip \
-    && pip install --no-cache-dir -r requirements.txt
+    && pip install --no-cache-dir --timeout 600 -r requirements.txt
 
 COPY . .