Installation

Installation

What you need

Ollama. Draggy does not ship a model runtime; it drives Ollama over localhost. If Draggy cannot find it on launch it will offer to install it for you, or you can get it yourself from ollama.com.

A graphics card, ideally. Draggy runs on anything, but the experience is decided almost entirely by how much VRAM you have. Four gigabytes is where it starts being pleasant. Below that it will pick smaller models and lean on the processor, which works but is slow enough that you will notice every reply. Apple Silicon does well because the memory is shared with the GPU.

Disk space. Around 10 GB for a typical model, plus a few hundred megabytes for the speech models if you use voice mode. Draggy checks free space before it downloads anything and refuses rather than filling your drive.

Installing

Download the installer for your platform from the Releases page.

• Windows — draggy_setup.exe. It asks where to install and does not require administrator rights.
• Linux — the AppImage runs as-is once you mark it executable, or install the .deb with sudo dpkg -i.
• macOS — build it yourself for now, see Building from Source. There is no signed release, so a downloaded build would not be able to update itself.

The first launch

The first launch does more work than the rest. Draggy checks that Ollama is running, looks at your hardware, and if you have no usable model installed it picks one sized to your graphics card and downloads it. That download is the long part — a few gigabytes, once.

The splash screen tells you which stage it is on. If it stalls, see Troubleshooting.

After that, launches are quick. Nothing is downloaded again unless you ask for a different model or turn on voice mode for the first time.

Where things are kept

Everything lives in Electron's user data folder for the app:

• Windows: %APPDATA%\Draggy
• macOS: ~/Library/Application Support/Draggy
• Linux: ~/.config/Draggy

Inside it you will find draggy.db (chats, settings, the document index), created_files/ (anything the assistant wrote for you), code_runs/ (scratch directories from the code tool) and model-cache/ (the speech models). Models themselves belong to Ollama and live wherever Ollama keeps them.

Deleting that folder resets Draggy completely without touching your models.

Updates

Draggy updates itself. With Automatic updates on — it is on by default — it looks for a new version twenty seconds after launch and every six hours after that, downloads what it finds in the background, and installs it the next time you quit.

Turn it off in Settings → Updates and nothing happens unless you press Check now. The same panel has Download and Restart and install buttons when an update is waiting.

Updates only work in an installed build. Running from source, the panel will say updates are disabled, which is correct.