Skip to content

docs: add Linux prerequisites and troubleshooting to building_in_linux.md#360

Open
timotif wants to merge 2 commits intoZackriya-Solutions:devtestfrom
timotif:docs/linux-build-prerequisites
Open

docs: add Linux prerequisites and troubleshooting to building_in_linux.md#360
timotif wants to merge 2 commits intoZackriya-Solutions:devtestfrom
timotif:docs/linux-build-prerequisites

Conversation

@timotif
Copy link

@timotif timotif commented Feb 19, 2026

Description

Fixes gaps in the Linux build guide discovered while following it on a clean Ubuntu system with an NVIDIA GPU and CUDA installed via apt.

Related Issue

N/A — discovered during manual testing of the build guide.

Type of Change

  • Bug fix
  • New feature
  • Documentation update
  • Performance improvement
  • Code refactoring
  • Other

Changes

  • Step 1 dependencies: expanded the apt/dnf/pacman commands to include all Tauri system dev libraries (libglib2.0-dev, libgtk-3-dev, libwebkit2gtk-4.1-dev, etc.). The original commands only listed build-essential cmake git, which caused a glib-2.0 not found error at compile time. Runtime packages alone are not sufficient — the -dev variants with headers and .pc files are required.

  • Step 1a (pnpm/nvm): added a new step explaining that corepack enable pnpm is required when managing Node.js via nvm, since pnpm is not automatically on PATH in that setup.

  • Step 1a (CUDA linker path): added a step under the NVIDIA CUDA section explaining that Ubuntu's apt CUDA packages install static libraries to /usr/lib/x86_64-linux-gnu/ rather than the /usr/local/cuda/lib64/ layout the build system expects. Without this, the build fails with could not find native static library 'cudart_static'.

  • Troubleshooting: added entries for cudart_static not found, glib-2.0 not found, and pnpm not found.

Testing

  • Manual testing performed — followed the updated guide from a clean Ubuntu system and confirmed a successful build producing both .deb and .AppImage bundles.
  • Unit tests added/updated — N/A (documentation only)
  • All tests pass — N/A

Documentation

  • Documentation updated

Checklist

  • Code follows project style
  • Self-reviewed the code
  • Added comments for complex code — N/A
  • Updated README if needed — README already links to this guide

sujithatzackriya and others added 2 commits February 11, 2026 18:14
## Description
This PR delivers a focused update improving provider model management, fixing API key persistence issues, enhancing Whisper model support, and bundling FFmpeg at build time for a smoother first-run experience.

Key highlights include:

* Dynamic real-time model fetching from OpenAI, Anthropic, and Groq (when API key is provided)
* Build-time FFmpeg bundling with 3-tier fallback (bundled → dev → system)
* Support for Q5_1 quantized Whisper models (tiny, base, small)
* Centralized provider API key management
* Proper model and endpoint state preservation when switching providers
* Multiple Whisper metadata corrections
* Windows system audio device reset fix
* Transcript copy newline preservation
* UI improvements to model selection and notifications
---

## Related Issue

Fixes Zackriya-Solutions#307
Fixes Zackriya-Solutions#346
Fixes Zackriya-Solutions#322
Fixes Zackriya-Solutions#323

(Also includes fixes reported by community members in related provider/model issues.)

---

## Type of Change

* [x] Bug fix
* [x] New feature
* [ ] Documentation update
* [x] Performance improvement
* [x] Code refactoring
* [ ] Other (please describe)

---

## Testing

* [x] Unit tests added/updated
* [x] Manual testing performed
* [x] All tests pass

Tested scenarios include:

* Provider switching with API key persistence
* Model selection preservation per provider
* Dynamic model fetching with valid API keys
* Custom OpenAI-compatible endpoint connection testing
* Whisper model downloads and metadata validation
* Q5_1 model loading and transcription
* FFmpeg resolution (bundled/dev/system fallback)
* Windows system audio device persistence
* Transcript copy with preserved newlines

---

## Documentation

* [x] Documentation updated
* [ ] No documentation needed

Updated:

* Release notes

---

## Checklist

* [x] Code follows project style
* [x] Self-reviewed the code
* [x] Added comments for complex code
* [x] Updated README if needed
* [x] Branch is up to date with devtest
* [x] No merge conflicts

---

## Additional Notes
* FFmpeg download source switched to Zackriya’s GitHub release for improved Windows reliability.
* Model fetching now occurs dynamically when opening the model selector and an API key is present.
* Provider-specific model selection and endpoints are now cached and automatically restored.
* Includes contributions from:
  * @matbe (Windows audio fix, Whisper metadata corrections)
  * @5m4u66y (OpenAI-compatible API connection test fix)
…x.md

- Add Tauri system dev libraries (glib, gtk, webkit, etc.) to the apt/dnf/pacman
  install commands — runtime packages alone are insufficient to compile
- Add Step 1a for pnpm via corepack (needed when using nvm)
- Add Step 1a under CUDA setup for Ubuntu apt linker path fix (.cargo/config.toml)
- Add troubleshooting entries for cudart_static not found, glib not found, and
  pnpm not found errors
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants