Skip to content

Install klars ​

klars has desktop builds for Apple Silicon Macs and Windows x64. Linux access uses a browser connected to klars serve.

Availability

Public downloads are not listed here yet. Visit klars.dev for availability. The steps below apply if you already have a release artifact from a trusted distribution channel.

macOS · Apple Silicon ​

Releases are distributed as a disk image (.dmg). Current builds are unsigned and not notarized.

  1. Move klars to Applications

    Open the disk image and drag klars.app into /Applications.

  2. Open the app

    In Finder, right-click klars.app and choose Open for the first launch.

  3. Choose your Python environment

    When opening your model, go to Graph actions → Model setup → Python environment. Use the absolute path to your project’s interpreter.

If macOS still blocks a copy you trust, remove its quarantine attribute and try again:

sh
xattr -dr com.apple.quarantine /Applications/klars.app

Version 0.1.0 used the name klars Local.app. If you have that release, use its actual name in the path.

Windows · x64 ​

Releases include an unsigned installer (.exe) and a portable ZIP. Run the installer, or extract the entire ZIP and open klars.exe.

Microsoft Defender SmartScreen may show Windows protected your PC. For an artifact you obtained from a trusted source, choose More info → Run anyway.

Python and model libraries ​

Python and PyTorch are not bundled. The app uses an environment on your machine. That environment also needs the libraries your model imports; Hugging Face models need Transformers.

An app launched from Finder does not inherit your terminal’s active virtual environment. Select an absolute interpreter path in Model setup. Python troubleshooting →

Browser and Linux ​

A provisioned klars serve installation serves the same workspace without a desktop window. You need Node.js 22.13 or newer and a suitable machine Python environment. See remote browser access for SSH forwarding and startup.

There is no public headless archive download linked from these docs yet.

Update your desktop app ​

Quit klars fully, replace the app with the newer release, and open it again. On macOS, use ⌘ Q; closing its window leaves the app running. You may need to approve a new unsigned copy again.

Workspace data lives separately in ~/.klars/app. Replacing the app does not remove that directory. Continue with first launch.

Your models. Your machine. Your next idea.