2e72fd4ded19d2bf2ff1edd20d38b02d94147ef2
12
Commits
| Author | SHA1 | Message | Date | |
|---|---|---|---|---|
 Kanishk PachauriandGitHub
|
2e72fd4ded | ci: limit workflow tokens to repository reads (#866) | ||
|
SergeyandGitHub
|
b45a26e1cd | feat(ci): run install.sh in the distro matrix instead of grepping it (#810) | ||
|
SergeyandGitHub
|
a46000e249 | chore(ci): test the distros the docs promise, and fix the docs that drifted (#773) | ||
|
|
3c94f021fd |
chore(deps): bump the github-actions group with 11 updates (#766)
Bumps the github-actions group with 11 updates: | Package | From | To | | --- | --- | --- | | [actions/checkout](https://github.com/actions/checkout) | `5.1.0` | `7.0.1` | | [actions/labeler](https://github.com/actions/labeler) | `6.2.0` | `7.0.0` | | [actions/setup-python](https://github.com/actions/setup-python) | `5.6.0` | `7.0.0` | | [actions/cache](https://github.com/actions/cache) | `4.3.0` | `6.1.0` | | [actions/upload-artifact](https://github.com/actions/upload-artifact) | `4.6.2` | `7.0.1` | | [softprops/action-gh-release](https://github.com/softprops/action-gh-release) | `2.6.2` | `3.0.2` | | [actions/download-artifact](https://github.com/actions/download-artifact) | `4.3.0` | `8.0.1` | | [actions/setup-node](https://github.com/actions/setup-node) | `5.0.0` | `7.0.0` | | [dorny/paths-filter](https://github.com/dorny/paths-filter) | `3.0.4` | `4.0.3` | | [astral-sh/setup-uv](https://github.com/astral-sh/setup-uv) | `6.8.0` | `10.0.1` | | [codecov/codecov-action](https://github.com/codecov/codecov-action) | `4.6.0` | `7.0.0` | Updates `actions/checkout` from 5.1.0 to 7.0.1 - [Release notes](https://github.com/actions/checkout/releases) - [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md) - [Commits](https://github.com/actions/checkout/compare/fbc6f3992d24b796d5a048ff273f7fcc4a7b6c09...3d3c42e5aac5ba805825da76410c181273ba90b1) Updates `actions/labeler` from 6.2.0 to 7.0.0 - [Release notes](https://github.com/actions/labeler/releases) - [Commits](https://github.com/actions/labeler/compare/b8dd2d9be0f68b860e7dae5dae7d772984eacd6d...bf12e9b00b37c5c0ca2b87b79b2daf7891dbda13) Updates `actions/setup-python` from 5.6.0 to 7.0.0 - [Release notes](https://github.com/actions/setup-python/releases) - [Commits](https://github.com/actions/setup-python/compare/a26af69be951a213d495a4c3e4e4022e16d87065...5fda3b95a4ea91299a34e894583c3862153e4b97) Updates `actions/cache` from 4.3.0 to 6.1.0 - [Release notes](https://github.com/actions/cache/releases) - [Changelog](https://github.com/actions/cache/blob/main/RELEASES.md) - [Commits](https://github.com/actions/cache/compare/0057852bfaa89a56745cba8c7296529d2fc39830...55cc8345863c7cc4c66a329aec7e433d2d1c52a9) Updates `actions/upload-artifact` from 4.6.2 to 7.0.1 - [Release notes](https://github.com/actions/upload-artifact/releases) - [Commits](https://github.com/actions/upload-artifact/compare/ea165f8d65b6e75b540449e92b4886f43607fa02...043fb46d1a93c77aae656e7c1c64a875d1fc6a0a) Updates `softprops/action-gh-release` from 2.6.2 to 3.0.2 - [Release notes](https://github.com/softprops/action-gh-release/releases) - [Changelog](https://github.com/softprops/action-gh-release/blob/master/CHANGELOG.md) - [Commits](https://github.com/softprops/action-gh-release/compare/3bb12739c298aeb8a4eeaf626c5b8d85266b0e65...3d0d9888cb7fd7b750713d6e236d1fcb99157228) Updates `actions/download-artifact` from 4.3.0 to 8.0.1 - [Release notes](https://github.com/actions/download-artifact/releases) - [Commits](https://github.com/actions/download-artifact/compare/d3f86a106a0bac45b974a628896c90dbdf5c8093...3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c) Updates `actions/setup-node` from 5.0.0 to 7.0.0 - [Release notes](https://github.com/actions/setup-node/releases) - [Commits](https://github.com/actions/setup-node/compare/a0853c24544627f65ddf259abe73b1d18a591444...820762786026740c76f36085b0efc47a31fe5020) Updates `dorny/paths-filter` from 3.0.4 to 4.0.3 - [Release notes](https://github.com/dorny/paths-filter/releases) - [Changelog](https://github.com/dorny/paths-filter/blob/master/CHANGELOG.md) - [Commits](https://github.com/dorny/paths-filter/compare/0e4a8c6effa4802afeda77dc8d303f8176d7dfad...ceb8a2b8f2d89434be7ff52d3de7ec3738c5cc9d) Updates `astral-sh/setup-uv` from 6.8.0 to 10.0.1 - [Release notes](https://github.com/astral-sh/setup-uv/releases) - [Commits](https://github.com/astral-sh/setup-uv/compare/d0cc045d04ccac9d8b7881df0226f9e82c39688e...20cfd1bf945f4377ade1205e4dbc17946fc9a30d) Updates `codecov/codecov-action` from 4.6.0 to 7.0.0 - [Release notes](https://github.com/codecov/codecov-action/releases) - [Changelog](https://github.com/codecov/codecov-action/blob/main/CHANGELOG.md) - [Commits](https://github.com/codecov/codecov-action/compare/b9fd7d16f6d7d1b5d2bec1a2887e65ceed900238...fb8b3582c8e4def4969c97caa2f19720cb33a72f) --- updated-dependencies: - dependency-name: actions/checkout dependency-version: 7.0.1 dependency-type: direct:production update-type: version-update:semver-major dependency-group: github-actions - dependency-name: actions/labeler dependency-version: 7.0.0 dependency-type: direct:production update-type: version-update:semver-major dependency-group: github-actions - dependency-name: actions/setup-python dependency-version: 7.0.0 dependency-type: direct:production update-type: version-update:semver-major dependency-group: github-actions - dependency-name: actions/cache dependency-version: 6.1.0 dependency-type: direct:production update-type: version-update:semver-major dependency-group: github-actions - dependency-name: actions/upload-artifact dependency-version: 7.0.1 dependency-type: direct:production update-type: version-update:semver-major dependency-group: github-actions - dependency-name: softprops/action-gh-release dependency-version: 3.0.2 dependency-type: direct:production update-type: version-update:semver-major dependency-group: github-actions - dependency-name: actions/download-artifact dependency-version: 8.0.1 dependency-type: direct:production update-type: version-update:semver-major dependency-group: github-actions - dependency-name: actions/setup-node dependency-version: 7.0.0 dependency-type: direct:production update-type: version-update:semver-major dependency-group: github-actions - dependency-name: dorny/paths-filter dependency-version: 4.0.3 dependency-type: direct:production update-type: version-update:semver-major dependency-group: github-actions - dependency-name: astral-sh/setup-uv dependency-version: 10.0.1 dependency-type: direct:production update-type: version-update:semver-major dependency-group: github-actions - dependency-name: codecov/codecov-action dependency-version: 7.0.0 dependency-type: direct:production update-type: version-update:semver-major dependency-group: github-actions ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> |
||
|
SergeyandGitHub
|
0ba029b015 |
chore(release): make a release verifiable, and pin what builds it (epic #701, phase 5) (#759)
* chore(release): build once, and publish sha256sums and provenance (epic #701, phase 5) * chore(ci): pin every third-party action by commit sha (epic #701, phase 5) * test(ci): anchor the dependabot guard on the ecosystem it must cover |
||
|
Sergey SilaevandGitHub
|
582d494633 |
chore(build): uv tooling, a Python 3.11 floor, and verified model downloads (epic #701, phases 2.5 & 5) (#713)
* chore(build): migrate justfile tooling to uv All recipes now run through 'uv run' against .venv, with a shared DEV_EXTRAS variable (dev + vad) because uv syncs the environment exactly and would otherwise uninstall the dev tools between recipes. 'deps' installs dev+vad; new 'deps-all' covers every extra. 'build' switches to 'uv build'; 'version' uses --no-sync. Bump [tool.uv] required-version to >=0.12,<0.13 for uv 0.12.x, and raise the mypy python_version target to 3.12: mypy 1.19 in the lock cannot target 3.9 and numpy 2.x stubs need a 3.12 target to parse (mypy is not run in CI or pre-commit; this only affects 'just typecheck'). * fix(tests): isolate test runs from real XDG state; fix Arch model-path crash Local test runs failed en masse (185 failures) while CI stayed green: tests picked up the developer's real ~/.local/share/vocalinux models via the default XDG paths and switched IBus/keyboard code paths through the desktop session env (XDG_CURRENT_DESKTOP/ XDG_SESSION_TYPE on GNOME/Wayland, issue #478 branches). conftest now points XDG base dirs at a throwaway session-wide directory and clears session variables at import time, mirroring a fresh CI runner (paths like MODELS_DIR freeze at first import during collection, so fixture-time isolation is too late). Also guard the Arch branch of _get_system_model_paths(): it removed /usr/local/share/vocalinux/models unconditionally and crashed with ValueError on Arch hosts when a custom XDG_DATA_DIRS never added that path. Add regression tests, and make the lock-file test assert the actual $XDG_DATA_HOME/vocalinux contract instead of the hardcoded ~/.local/share default. * fix(tests): keep the IBus engine double a plain class Python 3.14's unittest.mock re-instantiates a user subclass when it builds child mocks (klass(name=...)). VocalinuxEngine inherits from whatever IBus.Engine resolves to, and the test module bound that to the MagicMock class itself, so every engine instantiation raised TypeError: VocalinuxEngine.__init__() got an unexpected keyword argument 'name' on 3.14 while passing on 3.13. Replace it with a plain stand-in class that still hands out per-instance MagicMocks for the IBus API surface the engine touches. The same pattern remains in test_ibus_engine.py, test_ibus_engine_utils.py, test_ibus_active_engine_guard.py and test_ibus_xkb_wayland.py; those never instantiate the engine, so they are unaffected for now. * fix(install): build the venv from the system Python install.sh looked up a bare `python3` from PATH. Started from an activated virtualenv — a shell left in uv's .venv after `just deps` — it built venv/ from that interpreter, where distro PyGObject is invisible even with --system-site-packages, and the run aborted with Distro PyGObject (python3-gi / python3-gobject) is not importable in the venv. A mismatched venv/ then survived every retry, because the installer reuses whatever venv it finds. - drop an inherited VIRTUAL_ENV (and its bin from PATH) before any interpreter lookup - select the interpreter explicitly: $SYSTEM_PYTHON (default /usr/bin/python3) or PATH python3, preferring one that can import gi, and create the venv with it instead of `python3` - recreate venv/ when it was built by a different interpreter - name the interpreter in the PyGObject guard's error Documents the two environments (uv's .venv for tooling, venv/ for the installed app) in CONTRIBUTING, the justfile header and AGENTS.md, and adds the mismatch symptom to the INSTALL troubleshooting section. * chore(python): raise the supported floor to 3.11 requires-python promised 3.9 while the CI matrix ran 3.9/3.10/3.11/3.13, the classifiers advertised up to 3.14, mypy targeted 3.12 and install.sh enforced 3.9 — five different answers to "which Python does this support". Settle on 3.11 everywhere: pyproject (requires-python, classifiers, black targets), install.sh's MIN_VERSION, check-system-deps.sh, the distro package map, the CI matrix (now 3.11-3.14, matching the classifiers), the release and nightly workflows, and the docs. mypy now targets the floor instead of 3.12, so type checking covers what we promise; numpy 2.x ships stubs in 3.12 syntax that a 3.11 target cannot parse, so its imports are skipped. (mypy has 71 pre-existing errors either way; no CI job gates on it.) uv.lock and the requirements/* exports are regenerated — dropping 3.9/3.10 removes most of the version-conditional resolution branches. tests/test_python_version_policy.py pins the invariant: install.sh's floor, requires-python, the classifiers and the CI matrix must agree. * ci: run lint and tests from uv.lock The lock file and the hash-pinned exports were not enforced anywhere: CI still built a venv by hand and installed unpinned `PyGObject` plus `-e ".[dev,vad]"`, so the tool versions it checked against had nothing to do with the ones `just lint` uses locally. Both Python jobs now use astral-sh/setup-uv and run through `uv sync --locked` / `uv run --locked`, which also fails the build when uv.lock drifts from pyproject.toml. Partially covers phase 5 of #701 (tests install from the lock, lock freshness gate); trusted publishing, artifact checksums and action SHA pinning are still open there. * ci: lint from a dedicated dependency group The lint job failed on this branch: `uv run --extra dev` syncs the whole project, so it tried to build pyaudio from source on a runner that installs no system dependencies. src/pyaudio/device_api.c:9:10: fatal error: portaudio.h: No such file or directory Move black/isort/flake8 out of the `dev` extra into a `lint` dependency group. CI runs `uv run --locked --only-group lint`, which installs the three pure-Python tools and skips the project entirely — no portaudio or girepository headers needed. `just deps` and DEV_EXTRAS request the group alongside the dev extras, so the local environment still carries test and lint tooling at once and `just lint` matches CI version for version. pre-commit is unaffected: its hooks pin their own tool versions upstream. * fix(install): never configure an engine the venv cannot import vosk became an optional extra in #705, but the installer still writes `"engine": "vosk"` into config.json on the whisper.cpp fallback path even when installing the extra only produced a warning. config.json also survives reinstalls — every writer guards on "file does not exist" — so an engine picked by an earlier attempt outlives the venv that supported it. Either way Vocalinux dies at startup: ModuleNotFoundError: No module named 'vosk' - the fallback now writes the vosk config only when `import vosk` actually succeeds, and otherwise leaves the engine configuration alone - a new verify_configured_engine() runs near the end of the install: if config.json selects vosk and the venv cannot import it, it says so and prints both fixes instead of leaving a broken install behind * feat(models): verify every model download against a pinned digest Pins a sha256/md5 per downloadable speech model in src/vocalinux/utils/model_checksums.txt and verifies against it in both install.sh and the runtime downloaders, before the file is moved into place. Verification fails closed. Covers phase 2.5 of #701; see the PR for details. * docs(agents): rebase AGENTS.md onto the #727 rewrite * fix(install): hash models that are already on disk instead of trusting them * refactor(models): one download path per engine, and fix Whisper's * docs(install): drop distros that cannot meet the 3.11 floor * docs: retire the distros and Python versions the 3.11 floor rules out * fix(install): abort instead of warning when Python is below the floor * fix(install): fall back to the system Python, not the one on PATH * fix(install): match an existing venv by installation, not by X.Y * fix(install): repair a config naming an engine the venv cannot import * fix(models): pin VOSK by the sha256 of bytes we fetched, not upstream's md5 * fix(justfile): request the dev set in every recipe that syncs * test(version): scan the docs and website trees for a stale Python floor * docs: correct the stale model-checksum and distro claims * fix(models): stamp the VOSK tree the app extracts, as the installer does * fix(install): replace an unverified VOSK model only once its successor is ready * docs(install): align the Fedora floor with the rest of the tree * test(install): drop an f-string with no placeholders * test(models): stub the downloader probe the VOSK installer test relies on * docs: drop the long dashes from two model-checksum comments * fix(install): gate on the interpreter, not on the distro release label * fix(justfile): export the lint group into requirements/dev.txt * fix(models): unpack the VOSK tree into staging and stamp it before the swap * fix(whisper): adopt a checkpoint an earlier release stored under the catalog name * docs(settings): state what a stray Whisper copy really means for deletion * fix(models): hash a whisper.cpp model found on disk before it reaches ctypes * docs(contributing): stop telling readers to uninstall their linters * fix(install): stop warning off distros the project documents as supported * docs(distros): file the supported derivatives under supported |
||
|
|
5505e1040e |
fix(ci): clear website pipeline lint and action warnings (#611)
Fix ESLint errors for hash install links, anonymous default-export warnings, and the ineffective next.config headers() that warned under static export. Correct softwareVersion sync to match unquoted JS keys, and bump Actions to Node-24 runtimes so deprecation notices stop. Co-authored-by: Cursor Agent <cursoragent@cursor.com> Co-authored-by: Jatin K Malik <jatinkrmalik@users.noreply.github.com> |
||
|
Jatin K MalikandGitHub
|
9c16ab0aad |
chore: remove stale setup.py and build-website.sh (#326)
- Remove setup.py: redundant with pyproject.toml, had drifted deps (missing pywhispercpp, psutil, evdev; no platform markers; stale Python 3.12 max). pip has supported pyproject.toml since v21.3 (2021). - Remove build-website.sh: broken script referencing non-existent fix-paths.sh. Web deploy is handled by npm scripts and GitHub Actions. - Clean up CI triggers: remove setup.py and setup.cfg references from distro-test-matrix.yml and unified-pipeline.yml path filters. |
||
|
Jatin K MalikandGitHub
|
98cf90c418 |
ci: add path-based filtering to skip unnecessary builds (#319)
- unified-pipeline.yml: replace blanket .github/workflows/** glob with specific .github/workflows/unified-pipeline.yml in both web and python filters, so editing nightly.yml or release.yml no longer triggers the full lint/test/build matrix - distro-test-matrix.yml: add paths filter at workflow trigger level so the 4-container distro matrix only runs when installer, scripts, packaging, or version files change (previously ran on every push/PR including doc-only and web-only changes) Saves CI minutes on documentation, website, and unrelated workflow edits. |
||
|
Jatin K MalikandGitHub
|
57a0ddd0b8 |
feat(speech): add whisper.cpp with Vulkan support for GPU acceleration (#179)
* feat(speech): add whisper.cpp with Vulkan support for GPU acceleration Add whisper.cpp as a new speech recognition engine with the following features: - Vulkan GPU acceleration support (AMD, Intel, NVIDIA) - Fallback to CUDA for NVIDIA GPUs - CPU-only mode with automatic thread optimization - Support for all model sizes: tiny, base, small, medium, large - Hardware detection to recommend best model/backend - Models downloaded from Hugging Face (ggml format) - Updated UI to show compute backend info in settings - pywhispercpp as the Python binding library - whisper_cpp as the new default engine Changes: - New whispercpp_model_info.py with model metadata and hardware detection - Updated recognition_manager.py with whisper.cpp init and transcription - Updated settings_dialog.py with whisper.cpp UI support - Updated config_manager.py with whisper_cpp_model_size config - Updated main.py with whisper_cpp CLI option - Updated pyproject.toml with pywhispercpp dependency - Updated install.sh with vulkan-tools for GPU detection Closes #104 * style: fix black and isort formatting issues * test: update config manager test for whisper_cpp default engine * feat(install): interactive mode with 3 engine choices and whisper.cpp as default Major changes to install.sh: - Interactive mode is now the DEFAULT (not --auto) - Added --auto flag for non-interactive automatic installation - New --engine flag to specify engine directly - Interactive mode shows 3 engine options with visual boxes: 1. whisper.cpp (recommended) - Vulkan/CUDA/CPU support 2. whisper (OpenAI) - PyTorch-based, NVIDIA-only 3. VOSK - lightweight option - Hardware detection with recommendations: - Detects Vulkan support (AMD/Intel/NVIDIA) - Detects NVIDIA CUDA - Checks available RAM - Recommends best engine based on hardware - Updated help text with new options and examples - Removed old --with-whisper, --whisper-cpu, --no-whisper flags - whisper.cpp is now the default engine for automatic mode * feat(uninstall): kill running vocalinux processes before uninstall * fix(whisper.cpp): auto-download model, use all CPU cores, hide unavailable engines Three fixes for whisper.cpp implementation: 1. Auto-download model during install - Added install_whispercpp_model() function to install.sh - Downloads ggml-tiny.bin (~39MB) from Hugging Face - Runs automatically when whisper.cpp engine is selected 2. Use all CPU cores for transcription - Added n_threads parameter to Model initialization - Uses multiprocessing.cpu_count() to get all cores - Significantly improves transcription speed 3. Hide unavailable engines from dropdown - Added get_available_engines() function to detect installed engines - Settings dialog now only shows engines that are actually installed - Falls back to first available engine if current not available Fixes user-reported issues with whisper.cpp integration. * ui(settings): display whisper.cpp correctly and increase dialog height - Changed engine display name from 'whisper_cpp' to 'whisper.cpp' - Added format_engine_display_name() helper function - Dialog now uses 75% of screen height for better visibility - More options visible by default without scrolling * revert(settings): remove display name change, keep dialog height increase - Reverted engine display name change (was breaking engine selection) - Kept dialog height at 75% of screen for better visibility * style: fix black and isort formatting for whisper.cpp logging * style: fix black formatting in settings_dialog.py * ci: fix Fedora 39 container package installation Add dnf cache update and fallback with --nogpgcheck for Fedora containers that may have stale or missing package metadata. |
||
|
Jatin K MalikandGitHub
|
8e48b997a5 |
ci: Actually test install.sh distro detection in CI matrix (#163)
* docs: Add distribution package mapping reference Add a comprehensive YAML reference file documenting package names across different Linux distributions. This serves as: 1. Documentation for manual installation on unsupported distros 2. Reference for adding support for new distributions 3. Auxiliary reference for the installer's embedded package mappings Completes Task 6 from the cross-distribution compatibility fix plan. Related to: #158, #159, #160, #161 * ci: Actually test install.sh distro detection in CI matrix Previously, the distro-test-matrix.yml workflow only did syntax checks on install.sh without actually testing the core cross-distribution functionality that was added in phases 1-4. This update adds proper tests for: 1. Distro Detection - Tests detect_distro() function logic across different containers to verify proper identification of Ubuntu, Debian, Fedora, etc. 2. Typelib Path Detection - Tests detect_typelib_path() function which uses pkg-config and fallback paths for GI_TYPELIB_PATH 3. Virtual Environment Creation - Verifies Python venv can be created with minimal system dependencies 4. Dependency Checker - Runs check-system-deps.sh to see what's missing on each distro 5. Installer Help - Verifies install.sh --help works This ensures the cross-distribution compatibility improvements are actually tested by CI, not just syntax-checked. Related to: #158, #159, #160, #161, #162 * ci: Fix distro test - avoid sourcing install.sh (root check fails) The install.sh script has a root check that exits immediately when running as root, which causes CI to fail when we try to source it. Instead, we now test the distro detection logic directly without sourcing install.sh. This gives us the same test coverage while avoiding the root check issue. |
||
|
Jatin K MalikandGitHub
|
6b0e81c117 |
feat: Phase 4 - Testing & Polish improvements (#161)
Add testing infrastructure and documentation improvements. **Task 12: Add pkg-config to Core Dependencies** - Added pkg-config check at the start of install_system_dependencies() - Added pkg-config to all distribution package lists - Provides distro-specific install instructions if pkg-config is missing - Critical for library detection (GI_TYPELIB_PATH, PortAudio, etc.) **Task 13: Update README with Distro Info** - Updated Requirements section with tested distributions - Added link to DISTRO_COMPATIBILITY.md - Listed officially supported distros: Ubuntu 22.04+, Debian 11+, Fedora 39+, Arch, openSUSE - Mentioned experimental support for Gentoo, Alpine, Void, Solus **Task 14: Create Test Matrix for CI** - New workflow: .github/workflows/distro-test-matrix.yml - Tests on multiple container images: Ubuntu 22.04, 24.04, Debian 12, Fedora 39 - Runs dependency checker on each distro - Tests Python imports and bash syntax validation - Uses continue-on-error for experimental distro support **Task 15: Integration Testing Checklist** - New file: tests/distro-testing-checklist.md - Comprehensive checklist for testing on new distributions - Covers: Pre-install, Installation, Post-install, Functionality, Performance, Cleanup - Includes quick reference commands - Desktop environment and application-specific testing sections - Template for submitting test results Part of cross-distribution compatibility improvements (Phase 4 of 5). Related to #157 |