e330f9db70d05ed168273bb2c276f2f85d33ca73
13
Commits
| Author | SHA1 | Message | Date | |
|---|---|---|---|---|
|
f43f9dcd72 |
fix: leftover engine repair, just --no-sync, and ggml verify from #713 (#732)
* fix: leftover engine repair, just --no-sync, and ggml verify from #713 #713 only rewrote a broken config.json toward whisper_cpp, so a reinstall that kept the old engine still died when vosk was the extra that installed. verify_configured_engine now prefers SELECTED_ENGINE, then any working extra, and the vosk fallback rewrites an existing file. just recipes use uv run --no-sync so they do not prune extras from just deps-all. CONTRIBUTING lists libgirepository-2.0-dev for Ubuntu 24.04. An unverified ggml file is not loaded if unlink fails, and an unpinned name is refused rather than deleted. * fix(appimage): retry tooling downloads on curl reset * fix(build): bootstrap .venv for --no-sync just recipes and cover the contributor path in CI --------- Co-authored-by: Sergey Silaev <hello@8am.dev> |
||
|
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 |
||
|
Jatin K MalikandGitHub
|
4532b32f48 |
docs: require git worktrees and refresh AGENTS.md (#727)
Rewrite the root agent guide for current layout and toolchain, and make linked worktrees mandatory so the primary checkout stays on main. |
||
|
Jatin K MalikandGitHub
|
994dda10a6 |
fix(install): leftover review notes from #700 and #705 (#706)
* fix(install): leftover review notes from #700 and #705 The scratch dir now holds pip logs and model download temps, so a failed run has something to inspect. Dep, venv, leftover-process, and pip failures use exit codes 2/3/4 instead of a blanket 1. --help says the transcript is written during installation, and the tag hint is --tag=<release>. AGENTS.md no longer claims the hash-pinned exports are consumed (they wait for phases 2/3/5). Docs add a just install line and vocalinux[vosk] next to the PyPI commands. Settings points at --engine=whisper. The whisper.cpp fallback installs ".[vosk]". Fixes leftover review notes from #700 and #705. Refs #701. * fix(install): do not let pip build PyGObject from sdist Fresh --auto --skip-system-deps died on pygobject-3.56.3 even with distro python3-gi present. Install the other runtime deps from pyproject.toml, then pip install --no-deps. Extra installs use the extra's packages only, not pip install ".[extra]". Fixes leftover review notes from #700 and #705. Refs #701. * fix(install): tolerate unset XDG_SESSION_TYPE under set -u --auto with DISPLAY but no login session died on XDG_SESSION_TYPE: unbound variable. The session probe now uses ${XDG_SESSION_TYPE:-}, ${WAYLAND_DISPLAY:-}, and ${DISPLAY:-}. |
||
|
Sergey SilaevandGitHub
|
95d135ebbf |
chore(deps): lock dependencies with uv and pin every build input
Phases 0-1 of #701. Drops dead deps, moves vosk to an optional extra, adds uv.lock and hash-pinned requirements exports, pins pywhispercpp to 1.5.0. Closes #705. Refs #701. |
||
|
Sergey SilaevandGitHub
|
71c84fe86b |
chore(build): harden installer script and replace Makefile with Justfile
Stacked bottom of #701. Replaces Makefile with justfile and hardens install.sh (strict mode, logging, HTTP probes, curl -f on model downloads, no v0.10.1-beta fallback). Closes #700. |
||
|
Jatin K MalikandGitHub
|
c337d8f56d |
feat(shortcuts): default to hold Right Alt (push-to-talk) for new installs (#648)
* feat(shortcuts): default to hold Right Alt push-to-talk on first install Double-tap Ctrl conflicts with many desktop and app shortcuts, so new installs now use hold Right Alt (Option) in push-to-talk mode. Existing config.json values are preserved unchanged. Updates README, user guide, AGENTS.md, first-run dialog, website copy, and tests to match the new defaults. * refactor(shortcuts): trim redundant default-change test and comments Drop the fresh-install assertion that duplicated DEFAULT_CONFIG coverage, remove the duplicated Right-Alt rationale from config_manager, and drop a vacuous source-string check from the settings shortcuts test. * fix(shortcuts): align install.sh seeds and preserve legacy toggle mode install.sh still wrote ctrl+ctrl without mode, so merges with the new push_to_talk default became hold-Ctrl. Seed right_alt + push_to_talk for new installs, and migrate existing shortcut-only configs to mode=toggle so prior behavior is unchanged. * style(config): fix black formatting after shortcuts migration * fix(shortcuts): preserve legacy defaults when shortcuts section is missing Existing config files without a shortcuts section previously inherited ctrl+ctrl toggle from DEFAULT_CONFIG. Pin those historical defaults on upgrade so the new first-install Right Alt push-to-talk defaults do not silently change behavior. * docs(agents): unwrap hard-broken dictation control paragraph Keep the AGENTS.md paragraph as a single line like the surrounding prose. |
||
|
|
e097a6977f |
docs(agents): document Cursor Cloud dev environment setup (#594)
* docs(agents): add Cursor Cloud dev environment setup notes Co-authored-by: Jatin K Malik <jatinkrmalik@users.noreply.github.com> * docs(agents): note install.sh --dev --auto usage in cloud env Co-authored-by: Jatin K Malik <jatinkrmalik@users.noreply.github.com> * docs(agents): document running the desktop GUI app (tray + virtual mic) in cloud VM Co-authored-by: Jatin K Malik <jatinkrmalik@users.noreply.github.com> * chore(skills): add humanizer and ponytail agent skills for all repo sessions Co-authored-by: Jatin K Malik <jatinkrmalik@users.noreply.github.com> * docs(agents): note AppIndicator + librsvg2-common (SVG loader) needed for tray icon rendering Co-authored-by: Jatin K Malik <jatinkrmalik@users.noreply.github.com> * chore(skills): remove committed skills; install at user level (~/.cursor/skills) instead Co-authored-by: Jatin K Malik <jatinkrmalik@users.noreply.github.com> * docs(agents): reflow Cursor Cloud section to free-flowing lines; note pre-installed skills Co-authored-by: Jatin K Malik <jatinkrmalik@users.noreply.github.com> * docs(agents): reference ~/.local/bin/vocalinux-gui-env.sh GUI bring-up helper Co-authored-by: Jatin K Malik <jatinkrmalik@users.noreply.github.com> --------- Co-authored-by: Cursor Agent <cursoragent@cursor.com> Co-authored-by: Jatin K Malik <jatinkrmalik@users.noreply.github.com> |
||
|
Jatin K MalikandGitHub
|
b501235f1e |
feat(web): redesign marketing site with workstation craft (#582)
* feat(web): deslop marketing site with workstation craft identity Replace generic AI SaaS landing patterns with a deliberate Linux desk utility look: cool paper palette, Bricolage + Source Sans, solid type, editorial feature rows, and terminal install as first-class proof. Adds PRODUCT.md, DESIGN.md, and WEB-DESLOP-NOTES.md. Drops unused geist and react-intersection-observer. No product claim changes. * chore(web): drop local deslop working notes from PR WEB-DESLOP-NOTES.md was a firstmate/session artifact, not product docs. * fix(web): stop mobile horizontal overflow and harden viewport layout Long install URLs expanded the page past the phone width. Constrain terminal pre with break-all, min-w-0 columns, and overflow-x clip. Tighten mobile hero type and full-width CTAs. Add Playwright viewport QA script and jest checks that assert no overflow at desktop/tablet/mobile. * refactor(web): drop browser speech preview from marketing home Remove the cloud SpeechRecognition demo section and nav Demo link. Keep product truth: hero install, features, screenshots, engines. Fold shortcut/engine/audio links into the features intro. Delete unused LiveDemo component and its unit test. * chore(web): remove orphaned demo overlay and double-press hook Only LiveDemo used these; gone with the browser preview section. * feat(web): borrow PR #546 craft language into deslop home Merge closed redesign language onto feat/web-deslop-craft: pure white and near-black iron surfaces, emerald-committed palette, asymmetric hero with real app screenshots, full-bleed install strip, feature bento with tray/settings shots, and install-to-dictation steps. Keep Bricolage + Source Sans (not Geist), no browser speech demo, and mobile overflow guards. Update screenshots homepage expectations. * docs(design): align DESIGN.md tokens with PR #546 iron/emerald palette * fix(web): drop settings screenshot from installer details Uninstall sat too far below the list once the general-settings shot was in that column. Keep checklist, requirements, and uninstall only. * fix(web): raise light-mode primary and footer contrast Darken light emerald so white button text hits ~5:1 (was 3.4). Brighten install-strip and footer secondary text for legibility. Verified light/dark × desktop/tablet/mobile with no overflow. * fix(web): compact feature cards to kill empty vertical space Right-column tiles were h-full + justify-between next to a tall screenshot, so short copy left large voids. Use content-height cards with denser padding and inline link rows instead. * fix(web): pair settings shot with full feature rail Replace three orphan cards beside a tall dialog with a six-row feature panel that stretches with the screenshot frame. Crop the settings image with object-cover/object-top so heights match and no void sits next to the UI shot. * feat(web): apply homepage craft language to SEO child pages Rewrite SeoSubpageShell chrome (fixed nav, install pill, iron footer) to match the deslop home. Add subpage utilities and retoken all templated child routes: borders, radii, mono kickers, single emerald accent, terminal panels, no rainbow icon tiles or gradient cards. * fix(web): avoid invalid @apply hover:border-primary/40 in subpage-card * fix(web): rewrite subpage CSS without invalid Tailwind @apply * fix(web): color comparison X icons rose-red on alternatives Use soft rose (#c45c5c / #e08b8b) for no/cons marks so they read as distinct from emerald yes/checks without looking like form errors. * docs(web): move product/design docs under web/ and drop impeccable markers Keep PRODUCT.md and DESIGN.md next to the Next app (not repo root), add web/AGENTS.md as the entry point, and point the root AGENTS website section at those files. Strip tool-specific schema comments. * fix(web): use icon-only copy control on install terminal Replace the chunky Copy/Copied chip with a quiet clipboard icon that turns into a check on success. * fix(web): restyle system requirements as a spec rail Replace the nested bullet card with mono-label / value pairs under the installer section so it matches the craft language used elsewhere. * fix(web): center engine rows and quiet the Default badge Align name/badge with multi-line engine details on sm+; replace the filled green pill with a small mono outline chip. |
||
|
|
84ec79c769 |
chore(release): prepare v0.10.0-beta (#345)
* chore(release): prepare v0.10.0-beta Bump versions and release references across app, docs, installer, and website for the next beta release. Add v0.10.0-beta release notes entries covering reliability fixes and CI/test improvements since v0.9.0-beta. Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai> * docs(release): align Python baseline references to 3.9+ Synchronize stale Python 3.8 references in agent guidance and distro dependency docs/scripts with the current 3.9+ minimum used by project metadata and release docs. Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai> --------- Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai> |
||
|
Jatin K MalikandGitHub
|
6e02e928ae |
chore(release): prepare v0.7.0-beta (#255)
* chore(release): prepare v0.7.0-beta ## Version Bump (v0.6.3-beta → v0.7.0-beta) This is a major beta release with significant new features including autostart support, tabbed settings, and improved GPU detection. ### Core Version Files - Updated src/vocalinux/version.py to 0.7.0-beta - Updated pyproject.toml classifiers (already correct - Beta) ### Documentation - Updated README.md with new features, bug fixes, and version references - Updated docs/INSTALL.md with v0.7.0-beta install commands - Updated docs/UPDATE.md with comprehensive 'What's New' section - Updated SECURITY.md supported versions table (0.7.x now supported) ### Website - Updated web/src/app/page.tsx version badge (v0.7.0 Beta) - Updated web/src/app/page.tsx softwareVersion schema - Updated web/package.json version to 0.7.0 - Updated web/src/app/changelog/page.tsx with v0.7.0-beta release entry ### Other Updates - Updated install.sh default tag to v0.7.0-beta - Updated src/vocalinux/main.py error message install command - Updated AGENTS.md branch naming example ## Changes Since v0.6.3-beta ### New Features (13 commits) - Autostart on login support via XDG autostart - Tabbed settings dialog with 5 organized tabs - Intel GPU compatibility detection with automatic CPU fallback - Single instance prevention - Evdev device management to prevent CPU spin - Improved GPU detection avoiding false positives - IBus fallback when daemon not running - Fedora dnf check-update fix - Web SEO - 7 new optimized pages ### Contributors - Jatin K Malik (maintainer) - Antoine Monnet (contributor) - jatinkrmalik (contributor) ### Bug Fixes - #254: Improved GPU detection to avoid false positives - #251: Skip IBus setup when daemon not running - #243: Prevent dnf check-update from exiting script on Fedora - #240: Raise exception on IBus setup failure - #234: Removed leading space from first speech transcription - #242/#253: Removed disconnected evdev devices to prevent CPU spin ## Verification - [x] Lint passed - [x] Black formatting passed - [x] isort check passed - [x] Version imports correctly as 0.7.0-beta * docs: update version history in RELEASE_PROCESS.md Add entries for 0.6.0-beta through 0.7.0-beta to the version history table. |
||
|
Jatin K MalikandGitHub
|
2acf6899bd |
chore(release): prepare v0.6.2-beta (#224)
* chore(release): prepare v0.6.2-beta - Update version from 0.6.1-beta to 0.6.2-beta - Update documentation version references - Update website schema and badges Changes since v0.6.1-beta: - Fix #221: Add missing psutil dependency - Fix #219: Suppress [BLANK_AUDIO] tokens in whisper.cpp output - Fix #204: Resolve PyAudio paInt16 attribute error - Fix #205: Ensure whisper module installed with --auto - Improve Vulkan shader package detection for multiple distros - CI: Fix nightly build tag cleanup * docs(agents): update AGENTS.md with current project structure - Update speech recognition engines list (whisper.cpp is now default) - Add key dependencies section - Update project structure with whispercpp_model_info.py and vosk_model_info.py - Add release process quick summary * docs(agents): add important rules about PR workflow - Never push directly to main - All changes require a PR - Wait for CI before merging - Squash merge PRs |
||
|
Jatin K MalikandGitHub
|
1fe6b21017 |
docs: add AGENTS.md for AI coding agents (#127)
Add guidelines for AI agents working on this codebase including: - Build, lint, and test commands (including single test execution) - Code style guidelines (formatting, imports, types, naming) - Project structure overview - Commit message and branch naming conventions |