Draggy

Draggy is a desktop AI assistant that talks, browses and works on your own projects, all on models running on your own computer.

It runs models directly on your hardware via its built-in native GGUF engine (powered by llama.cpp) with open weights from Hugging Face, so by default there is no account, no API key, and no request leaving the machine unless you ask for one. An Electron app, in React and TypeScript, for Windows, macOS and Linux.

The wiki, at draggy.org/wiki, is where the rest lives: installing, requirements, every feature, troubleshooting, and how the app is built, in the same twelve languages the app speaks. Start with Installation, or Building and architecture if you are here to work on the code.

• Set up in a minute. The first launch asks your language, a light, dark or system theme, and which model to download, and downloads nothing before you choose. Skip takes the defaults.
• Chat with a local model. Draggy suggests a model that fits your computer, downloads the one you pick, and lets you swap it any time.
• Stay quick on small models. An efficient system prompt keeps 1B to 7B models responsive without cutting any instructions.
• Keep chats and code apart. A switch at the top of the sidebar, and each side keeps its own history, model and settings.
• Work in your projects. Open a folder and it reads, edits and runs commands there, showing every change as a diff you can undo.
• Decide how much it may do. Four permission modes, from only proposing to working alone. Anything outside the mode asks first.
• Steer the plan. Tick, reorder and edit its checklist while it works, and let tasks carry on in the background.
• Search, browse and make files. Web search, a built-in browser that blocks adverts, and Word, PowerPoint, Excel and PDF files.
• Search your own documents. Point it at a folder, indexed on your machine and searched by meaning and keywords at once.
• Extend it. A 107 MCP servers, the official registry and remote servers, plus 66 skills you start with / or leave to the model.
• Talk to it. A voice mode that knows when you have finished, answers out loud, and stops when you interrupt.
• Plug other tools in. An optional OpenAI-compatible API on 127.0.0.1, off by default and protected by a key.
• Bring another model in, if you want one. Add a server already running on your computer (Ollama, LM Studio, llama.cpp, vLLM, Lemonade) or a cloud provider with your own API key (OpenAI, Mistral, DeepSeek, Groq, OpenRouter and more). The built-in engine stays the default and fully local. A provider you add receives your conversations and the files its model reads, and its key stays in your system's keystore.

Pick your system on draggy.org, or take the installer straight from the Releases page. On first launch Draggy suggests a model sized to your hardware and downloads the one you choose, straight to your machine. See Installation for hardware requirements.

The macOS build is not notarised by Apple, so the first launch is blocked with Apple could not verify "Draggy" is free of malware. Click Done, not Move to Trash, then either:

• open System Settings → Privacy & Security, scroll down to "Draggy" was blocked and click Open Anyway, then confirm with your password; or
• clear the quarantine flag from Terminal after copying the app to Applications:

xattr -dr com.apple.quarantine /Applications/Draggy.app

This is needed once per install. Because the app is not notarised it also cannot update itself on macOS: download the new .dmg from the Releases page and repeat the step.

npm install

npm run electron:dev

Vite and Electron together with hot reload. See Building and architecture for how the code is laid out, CONTRIBUTING.md before sending a patch, and RELEASING.md for how versions are published.

Recorded in app.log (sanitized operational events) and debug.log (raw diagnostic traces) in the application data folder. See Troubleshooting and Building and architecture in the wiki.

• The quality of answers can vary a lot depending on the model choosen
• Generation speed depends heavily on the hardware of the user

Draggy is licensed under the Apache License 2.0. You can use, change, share and sell it, including in commercial products, as long as you keep the NOTICE file that credits Draggy.