nixorb 0.1.0__tar.gz

nixorb-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,61 @@
+name: CI
+
+on:
+  push:
+    branches: [main, dev]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    name: Test (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-22.04
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.12"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+
+      - name: Install system dependencies
+        run: |
+          sudo apt-get update -qq
+          sudo apt-get install -y --no-install-recommends \
+            libportaudio2 portaudio19-dev ffmpeg \
+            libglib2.0-0 libdbus-1-3 \
+            qt6-base-dev qt6-declarative-dev \
+            python3-dev
+
+      - name: Install Python dependencies (CPU-only torch for CI)
+        run: |
+          pip install --upgrade pip
+          pip install torch==2.7.1+cpu torchaudio==2.7.1+cpu \
+            --index-url https://download.pytorch.org/whl/cpu
+          pip install -e ".[dev]"
+          # Mock packages that require GPU or native libs in CI
+          pip install sounddevice soundfile numpy
+
+      - name: Lint with ruff
+        run: ruff check nixorb/ tests/
+
+      - name: Type-check with mypy
+        run: mypy nixorb/ --ignore-missing-imports
+
+      - name: Run tests
+        run: |
+          pytest tests/ \
+            --ignore=tests/test_vram_manager.py \
+            -v --tb=short
+
+      - name: Upload coverage
+        uses: codecov/codecov-action@v4
+        if: always()
+        with:
+          fail_ci_if_error: false

nixorb-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,367 @@
+name: Release
+
+on:
+  # ── Trigger 1: push a version tag  (git tag v0.1.0 && git push --tags)
+  push:
+    tags:
+      - 'v*.*.*'
+
+  # ── Trigger 2: click "Run workflow" on GitHub Actions tab
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version to release (e.g. 0.1.0)'
+        required: true
+        default: '0.1.0'
+      prerelease:
+        description: 'Mark as pre-release?'
+        required: false
+        default: 'false'
+        type: choice
+        options: ['false', 'true']
+      create_release:
+        description: 'Create GitHub Release?'
+        required: false
+        default: 'true'
+        type: choice
+        options: ['true', 'false']
+
+permissions:
+  contents: write
+  id-token: write   # for PyPI OIDC
+
+env:
+  PYTHON_VERSION: "3.12"
+
+# ── Resolve version from either tag or manual input ─────────────────── #
+jobs:
+  meta:
+    name: Resolve version
+    runs-on: ubuntu-22.04
+    outputs:
+      version:    ${{ steps.resolve.outputs.version }}
+      prerelease: ${{ steps.resolve.outputs.prerelease }}
+      tag:        ${{ steps.resolve.outputs.tag }}
+    steps:
+      - id: resolve
+        run: |
+          if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then
+            VERSION="${{ github.event.inputs.version }}"
+            PRERELEASE="${{ github.event.inputs.prerelease }}"
+          else
+            # Strip leading 'v' from tag name
+            VERSION="${GITHUB_REF_NAME#v}"
+            # Tags with a hyphen (v1.0.0-beta) are pre-releases
+            if echo "$VERSION" | grep -q '-'; then
+              PRERELEASE="true"
+            else
+              PRERELEASE="false"
+            fi
+          fi
+          TAG="v${VERSION}"
+          echo "version=$VERSION"    >> "$GITHUB_OUTPUT"
+          echo "prerelease=$PRERELEASE" >> "$GITHUB_OUTPUT"
+          echo "tag=$TAG"            >> "$GITHUB_OUTPUT"
+          echo "Resolved: version=$VERSION  prerelease=$PRERELEASE  tag=$TAG"
+
+  # ────────────────────────────────────────────────────────────────── #
+  #  Python wheel + sdist                                              #
+  # ────────────────────────────────────────────────────────────────── #
+  build-wheel:
+    name: Build Python Wheel
+    runs-on: ubuntu-22.04
+    needs: meta
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ env.PYTHON_VERSION }}
+
+      - name: Patch version in pyproject.toml
+        run: |
+          sed -i "s/^version = .*/version = \"${{ needs.meta.outputs.version }}\"/" pyproject.toml
+          grep "^version" pyproject.toml
+
+      - name: Build
+        run: |
+          pip install -q hatchling build
+          python -m build
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: python-dist
+          path: dist/
+
+  # ────────────────────────────────────────────────────────────────── #
+  #  Publish to PyPI (only on tag push or if manually enabled)        #
+  # ────────────────────────────────────────────────────────────────── #
+  publish-pypi:
+    name: Publish to PyPI
+    runs-on: ubuntu-22.04
+    needs: [meta, build-wheel]
+    # Skip PyPI publish on manual runs unless explicitly enabled
+    if: >
+      github.event_name == 'push' ||
+      (github.event_name == 'workflow_dispatch' &&
+       github.event.inputs.create_release == 'true')
+    environment:
+      name: pypi
+      url: https://pypi.org/p/nixorb
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: python-dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        continue-on-error: true   # don't fail the whole release if PyPI rejects
+
+  # ────────────────────────────────────────────────────────────────── #
+  #  Arch Linux pacman package                                         #
+  # ────────────────────────────────────────────────────────────────── #
+  build-pacman:
+    name: Build pacman package
+    runs-on: ubuntu-22.04
+    needs: meta
+    container:
+      image: archlinux:latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Bootstrap Arch build environment
+        run: |
+          pacman-key --init
+          pacman -Syu --noconfirm
+          pacman -S --noconfirm \
+            base-devel git python python-pip \
+            python-build python-installer python-wheel \
+            qt6-base qt6-declarative qt6-tools \
+            python-hatchling
+
+      - name: Patch version
+        run: |
+          VERSION="${{ needs.meta.outputs.version }}"
+          sed -i "s/^pkgver=.*/pkgver=${VERSION}/" packaging/PKGBUILD
+          sed -i "s/^version = .*/version = \"${VERSION}\"/" pyproject.toml
+
+      - name: Build source tarball
+        run: |
+          VERSION="${{ needs.meta.outputs.version }}"
+          python assets/generate_icon.py
+          tar --exclude='*.pyc' --exclude='__pycache__' \
+              --exclude='.git' --exclude='*.tar.gz' \
+              -czf "nixorb-${VERSION}.tar.gz" \
+              --transform "s|^|nixorb-${VERSION}/|" \
+              nixorb/ assets/ config/ plugins/ packaging/ \
+              tests/ pyproject.toml README.md LICENSE \
+              install.fish install.sh
+          SHA256=$(sha256sum "nixorb-${VERSION}.tar.gz" | cut -d' ' -f1)
+          echo "SHA256=$SHA256"
+          cp "nixorb-${VERSION}.tar.gz" packaging/
+          sed -i "s/sha256sums=.*/sha256sums=('${SHA256}')/" packaging/PKGBUILD
+
+      - name: Build package as non-root user
+        run: |
+          useradd -m builder
+          cp -r . /home/builder/nixorb
+          chown -R builder:builder /home/builder/nixorb
+          cd /home/builder/nixorb/packaging
+          su builder -c "makepkg --noconfirm --cleanbuild --skipinteg -d"
+          cp *.pkg.tar.zst /home/builder/
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: pacman-pkg
+          path: /home/builder/nixorb-*.pkg.tar.zst
+
+  # ────────────────────────────────────────────────────────────────── #
+  #  AppImage                                                          #
+  # ────────────────────────────────────────────────────────────────── #
+  build-appimage:
+    name: Build AppImage
+    runs-on: ubuntu-22.04
+    needs: meta
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ env.PYTHON_VERSION }}
+
+      - name: Install system deps
+        run: |
+          sudo apt-get update -qq
+          sudo apt-get install -y --no-install-recommends \
+            libportaudio2 portaudio19-dev ffmpeg libfuse2 \
+            qt6-base-dev qt6-declarative-dev qt6-tools-dev \
+            python3-dev
+
+      - name: Patch version
+        run: |
+          sed -i "s/^version = .*/version = \"${{ needs.meta.outputs.version }}\"/" pyproject.toml
+
+      - name: Install Python tools
+        run: |
+          pip install -q hatchling build
+          pip install -q torch==2.7.1+cpu \
+            --index-url https://download.pytorch.org/whl/cpu
+          pip install -q appimage-builder
+          pip install -q -e .
+
+      - name: Compile shaders
+        run: |
+          QSB=$(find /usr -name qsb -type f 2>/dev/null | head -1)
+          if [ -n "$QSB" ]; then
+            $QSB --glsl "100es,120,150" --hlsl 50 --msl 12 \
+              assets/shaders/orb_glow.vert -o assets/shaders/orb_glow.vert.qsb
+            $QSB --glsl "100es,120,150" --hlsl 50 --msl 12 \
+              assets/shaders/orb_glow.frag -o assets/shaders/orb_glow.frag.qsb
+          else
+            echo "WARNING: qsb not found, shaders not compiled"
+            touch assets/shaders/orb_glow.vert.qsb assets/shaders/orb_glow.frag.qsb
+          fi
+
+      - name: Build AppImage
+        env:
+          NIXORB_VERSION: ${{ needs.meta.outputs.version }}
+        run: |
+          cd packaging/appimage
+          bash build_appimage.sh "$NIXORB_VERSION"
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: appimage
+          path: packaging/appimage/NixOrb-*.AppImage
+
+  # ────────────────────────────────────────────────────────────────── #
+  #  Flatpak                                                           #
+  # ────────────────────────────────────────────────────────────────── #
+  build-flatpak:
+    name: Build Flatpak
+    runs-on: ubuntu-22.04
+    needs: meta
+    container:
+      image: bilelmoussaoui/flatpak-github-actions:kde-6.7
+      options: --privileged
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Patch version
+        run: |
+          sed -i "s/^version = .*/version = \"${{ needs.meta.outputs.version }}\"/" pyproject.toml
+
+      - name: Pre-download Python wheels
+        run: |
+          mkdir -p wheels
+          pip download -d wheels \
+            faster-whisper openai chromadb aiohttp qasync \
+            "pydantic>=2.7" pydantic-settings tomli-w "typer[all]" \
+            rich pygments openwakeword huggingface-hub cryptography \
+            aiofiles sounddevice soundfile numpy pynput hypernix \
+            2>/dev/null || true
+
+      - name: Build Flatpak
+        uses: bilelmoussaoui/flatpak-github-actions/flatpak-builder@v6
+        with:
+          bundle:        NixOrb-${{ needs.meta.outputs.version }}.flatpak
+          manifest-path: packaging/io.nixorb.NixOrb.yml
+          cache-key:     flatpak-builder-${{ github.sha }}
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: flatpak
+          path: NixOrb-*.flatpak
+
+  # ────────────────────────────────────────────────────────────────── #
+  #  Create GitHub Release                                             #
+  # ────────────────────────────────────────────────────────────────── #
+  create-release:
+    name: Create GitHub Release
+    runs-on: ubuntu-22.04
+    needs: [meta, build-wheel, build-pacman, build-appimage, build-flatpak]
+    if: >
+      always() &&
+      (github.event_name == 'push' ||
+       github.event.inputs.create_release == 'true')
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Download all artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: release-assets/
+
+      - name: Create or update git tag (manual runs only)
+        if: github.event_name == 'workflow_dispatch'
+        run: |
+          git config user.name  "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          TAG="${{ needs.meta.outputs.tag }}"
+          # Delete existing tag if present (allows re-running)
+          git tag -d "$TAG" 2>/dev/null || true
+          git push origin ":refs/tags/$TAG" 2>/dev/null || true
+          git tag "$TAG"
+          git push origin "$TAG"
+
+      - name: Generate changelog
+        id: changelog
+        run: |
+          PREV=$(git tag --sort=-version:refname | grep -v "${{ needs.meta.outputs.tag }}" | head -1 || true)
+          if [ -n "$PREV" ]; then
+            LOG=$(git log "${PREV}..${{ needs.meta.outputs.tag }}" --oneline --no-merges 2>/dev/null | head -40 || echo "Initial release")
+          else
+            LOG=$(git log --oneline --no-merges | head -20)
+          fi
+          {
+            echo 'changelog<<CHANGELOG_EOF'
+            echo "$LOG"
+            echo 'CHANGELOG_EOF'
+          } >> "$GITHUB_OUTPUT"
+
+      - name: Create release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name:   ${{ needs.meta.outputs.tag }}
+          name:       NixOrb ${{ needs.meta.outputs.version }}
+          draft:      false
+          prerelease: ${{ needs.meta.outputs.prerelease }}
+          body: |
+            ## NixOrb ${{ needs.meta.outputs.version }}
+
+            ### Install
+
+            **Arch Linux (recommended)**
+            ```bash
+            sudo pacman -U nixorb-${{ needs.meta.outputs.version }}-1-x86_64.pkg.tar.zst
+            ```
+
+            **PyPI**
+            ```bash
+            pip install nixorb==${{ needs.meta.outputs.version }}
+            ```
+
+            **AppImage (portable)**
+            ```bash
+            chmod +x NixOrb-${{ needs.meta.outputs.version }}-x86_64.AppImage
+            ./NixOrb-${{ needs.meta.outputs.version }}-x86_64.AppImage start
+            ```
+
+            **Flatpak**
+            ```bash
+            flatpak install NixOrb-${{ needs.meta.outputs.version }}.flatpak
+            flatpak run io.nixorb.NixOrb
+            ```
+
+            ### Changes
+            ${{ steps.changelog.outputs.changelog }}
+          files: |
+            release-assets/python-dist/*
+            release-assets/pacman-pkg/*
+            release-assets/appimage/*
+            release-assets/flatpak/*

nixorb-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 NixOrb Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.