Getting started

Install and run OpenLLM Studio on your machine.

OpenLLM Studio is a free, MIT-licensed, open-source local LLM app built with Tauri and Rust. It is a GPU-accelerated local LLM app that auto-detects your hardware, recommends the right model and quantization, and downloads GGUF models from Hugging Face through a llama.cpp GUI.

1

Download a pre-built binary

The fastest way to start is to download the latest release for your platform. The installer is about 5 MB; runtime binaries are downloaded on demand based on your hardware.

Windows

OpenLLM-Studio_x64-setup.exe

macOS

Apple Silicon & Intel builds

Linux

x86_64 AppImage / deb

On first launch the app detects your GPU, RAM, and CPU, then recommends the best runtime. You only download the inference binary you need.

2

Build from source

If you prefer to build locally, you will need Node.js 20.19+ (or 22.12+) and the latest stable Rust toolchain.

git clone https://github.com/Icecubesaad/OpenLLM-Studio.git
cd OpenLLM-Studio
npm install
npm run tauri dev

For production builds, run npm run tauri build and look for the bundle in src-tauri/target/release/bundle/.

3

Install system dependencies

Tauri requires native system libraries. Install the ones for your OS before running or building the app.

Windows

Install the Microsoft Visual C++ Build Tools with the Windows SDK and C++ workload.

macOS

xcode-select --install

Linux (Ubuntu / Debian)

sudo apt update
sudo apt install -y libwebkit2gtk-4.1-dev libappindicator3-dev librsvg2-dev patchelf libgtk-3-dev libayatana-appindicator3-dev

Linux (Arch / Fedora)

Install the equivalent Tauri dependencies for your distribution: webkit2gtk-4.1, libappindicator, gtk3, librsvg, and patchelf.

4

Understand runtime binaries

OpenLLM Studio uses llama.cpp binaries for inference. They are stored in your local app data directory and downloaded only when needed.

VariantPlatformUse case
CPUAllNo GPU available
CUDA 12.4 / 13.1Windows, LinuxNVIDIA GPUs
VulkanWindows, LinuxAMD / Intel GPUs
MetalmacOSApple Silicon

Binary storage paths:

  • Windows: %APPDATA%\com.openllm.studio\llama-binaries\
  • macOS: ~/Library/Application Support/com.openllm.studio/llama-binaries/
  • Linux: ~/.config/com.openllm.studio/llama-binaries/
5

Add a Hugging Face token

You can browse and download public GGUF models without an account. A token is only needed for private models or higher rate limits.

  1. Create or copy a token from your Hugging Face account.
  2. Open OpenLLM Studio and go to Settings.
  3. Paste the token in the Hugging Face section and save.
6

Troubleshooting

GPU not detected

Update to the latest GPU drivers. NVIDIA users should install the CUDA Toolkit; AMD users should install the latest drivers from AMD. Then check Settings → General → Hardware Info.

Binary download fails

Check your internet connection, try a different runtime engine in Settings → General, or switch to the CPU variant as a fallback. Firewalls and proxies can also block GitHub releases.

Build errors

Make sure Node.js is 20.19+ or 22.12+, then clear dependencies and the Rust cache:

rm -rf node_modules && npm install
cd src-tauri && cargo clean

Ready to run your first local model?

Download OpenLLM Studio, let the hardware wizard pick a model, and start chatting offline.