SovrGPT Desktop
SovrGPT Desktop is an AI agent for your Windows computer: it reads and edits files, runs commands, works in a browser of its own and, if you want, operates programs. It asks before writing steps and before every action in the browser or in programs. Model calls run through your SovrGPT account.
SovrGPT Desktop works on your computer, not just in a chat window. You give it a task, and the agent reads files, runs commands, opens web pages and comes back with a result. If you want, it also operates programs on your computer (see Desktop control).
Installation
The program runs on Windows 10 and 11 (64-bit) and does not need administrator rights. It installs for your user account.
- Sign in to SovrGPT and open the download page. There is no download without signing in, because the program cannot be used without a SovrGPT account. The page also shows the version, the size and the SHA-256 checksum of the file.
- Run the downloaded file.
- Sign in within the program (see Signing in).
The installer is not signed yet. Windows therefore shows "Windows protected your PC" on first start.
Click More info and then Run anyway. Only start the download with the button on the download
page of sovrgpt.com. The file itself comes through a short-lived storage link, so your browser's
download history shows a different address. If in doubt, compare the checksum with the one on the
download page:
(Get-FileHash ".\SovrGPT-Desktop-win32-x64-setup.exe" -Algorithm SHA256).HashFor managed computers there is a silent installation. In PowerShell, in the folder of the file:
.\SovrGPT-Desktop-win32-x64-setup.exe /SFor now the program does not update itself. To get a new version, download it from the download page and run it.
Signing in
On first start, click Sign in with your browser. Your browser opens, you compare the check code with the one in the program and confirm the connection. The program is then set up. This creates a separate key for this computer. It may call language models, use the SovrGPT tools (company knowledge, images, Office files, decisions), use dictation and speech output, and sync your own chats between the web and the program (see One chat list for web and desktop). You find it under Settings → API keys and can revoke it there at any time.
If the program shows Reconnect, your key comes from an older version. One click fetches a new key with the current rights; the old one is revoked afterwards.
On a computer without a signed-in browser, choose Use an API key instead.
Choosing and switching the organisation
When you confirm in the browser, you choose which of your organisations the program connects to. The organisation you are currently using on the web is preselected; your choice here does not change the organisation on the web. Costs go to the chosen organisation. The same prices and limits apply as in the chat. That organisation's settings apply too, such as a model allow list or a block on desktop control. What counts is always the organisation the program's key belongs to; the program shows it.
To switch, use Switch organisation in the program. Your browser opens again, you choose the new organisation and confirm. The key of the previous organisation is revoked afterwards, so each computer has only one key. After a switch, desktop control is off again, and you see the web chats of the new organisation. New chats from the program then appear on the web of the new organisation; chats already synced with the previous one stay on the computer, and syncing pauses for them.
What the agent may do
The agent has four sets of tools:
- Files and commands: read and write files, run commands on the command line.
- Browser: a browser of its own, just for the agent. It opens pages, reads them, fills in forms and presses buttons (see Browser).
- Desktop control: operate programs on your computer. Off by default (see Desktop control).
- SovrGPT: search your organisation's company knowledge, search the web and read pages, create images, create PowerPoint, Word, Excel and PDF files, build apps and use the Decision Engine: the same tools as in the web chat. Office files are created without any extra software on your computer.
The agent only installs software after you have explicitly agreed.
Whatever it creates for you goes to Documents\SovrGPT, in one subfolder per task. New chats work there; you choose another folder at the bottom of the input field. When an answer names a file, a card appears with a preview and the buttons Open and Show in folder. Files that could start programs are not opened directly.
Web search and reading pages
For research the agent first uses SovrGPT's web search and reads the pages it finds as text, without starting the browser. Its answer names the addresses of its sources. It only uses the browser when a page needs a login or a form, or when you explicitly ask for it. Web search runs through Brave Search, a provider in the USA; only the search term goes there (see Where your data goes). Each computer and each person can run at most 10 searches per minute and 300 in 24 hours, each organisation 900; the same applies to reading pages.
The agent only reads a page whose address came neither from you nor from the web search after you approve it in the window. This way an instruction slipped into a web page or a document cannot quietly send data to a foreign address.
Commands and apps
Type / in the input field to see three commands:
- /app builds a small app. The agent asks once whether you want a local app, a single HTML file in your SovrGPT folder that you open in your default browser with Open in browser on the file card (scripts in it run there), or a Craft app hosted by SovrGPT. A Craft app starts out private: the link only opens it for you until you share it on the web. If another of your organisations is active in the browser, the page offers to switch. Craft apps have no internet access; if an app needs live data such as the weather, the agent builds a local app. Craft apps are available from the Starter plan if your organisation allows apps.
- /craft creates a slide deck (PowerPoint), as in the web chat.
- /crafts opens your Crafts on
sovrgpt.comin your default browser.
Anything that does not match a command is sent as a normal message with Enter.
The Apps page in the sidebar collects both: local apps from your SovrGPT folder (open them with
Open in browser or Show in folder, move them to the recycle bin after a confirmation) and your organisation's Craft
apps, which open with Open on the web on sovrgpt.com and are managed there. New app opens a new
chat with /app in the input; nothing is sent until you send it.
The program combines working steps into one line ("SovrGPT completed 5 steps") that you can expand. With Settings → Chat → Response style: Detailed you see every step right away.
By default it runs reading steps on files without asking. It asks before writing steps. You see what it intends to do and allow it once or decline. You can change the level in the settings. In the Autonomous level SovrGPT creates, changes and deletes files and runs commands without asking; SovrGPT's protection rules still apply. The browser and desktop control follow stricter rules that cannot be relaxed (see below).
The agent works with your user rights. A web page, a file or a window can contain text meant to steer it towards something else. It is instructed to treat such text as content and not as a task, but that is not complete protection. Read the questions before you allow something, and do not leave it unattended with confidential data and open web pages at the same time.
Browser
The agent has a browser of its own that comes with the program. It is separate from your browser: it sees neither your logins nor your saved passwords. It does have its own persistent profile, though, and remembers where you have signed in within it. Under Settings → App → SovrGPT browser you sign in to a site yourself, without the agent watching, and delete those logins again.
- You allow reading per task. Without that approval the model only learns the result and the address of an action, not the content of the page.
- You confirm every action individually in a separate window: opening a page, clicking, typing. There is no "always allow" here. Only a real mouse click confirms; after two minutes without an answer the action counts as declined.
- You make the final click to buy, pay or transfer money yourself. On such a page the agent does not submit, and does not press Enter or Space.
- The browser belongs to one chat at a time. A second chat only gets it once the first has not used it for ten minutes. Settings → App → Release browser releases it immediately; the page and the reading approvals are forgotten afterwards.
Password saving, search suggestions, translation and usage data are switched off in the browser. Safe Browsing is off as well, because it sends requests to Google. Owners and admins can switch it on for the whole organisation under Settings → Approvals.
Desktop control
With desktop control the agent operates programs on your computer. It reads windows and controls through the Windows accessibility interface, clicks and types.
- Off by default. Only the person working at this computer can switch it on: under Settings → App, after a privacy notice that you confirm.
- Your organisation can block it. Owners and admins do this under Settings → Approvals. The block applies to every SovrGPT Desktop that is connected with a key of this organisation. Anyone who connects the program with a key of another organisation of their own, such as their personal one, is not covered by it; that organisation's setting applies there. The program applies the block as soon as it next fetches the settings, at the latest when it restarts. Without a connection to SovrGPT, or if SovrGPT cannot read the setting at the moment, desktop control stays off.
- You allow seeing per task and per program. You confirm every action individually; there is no "always allow". Each task allows at most 60 actions within 20 minutes.
- The agent never pays, buys or transfers money.
- Some programs it does not operate at all: command lines, system tools, remote access, password managers, banking programs and other browsers, nor any window running with administrator rights. It neither reads nor fills in password fields.
- If it cannot read a window through the accessibility interface, it takes a screenshot of that window, but only when the window is in front. It then does not click by itself: it marks the spot in red, and you click.
- While it is operating programs, a red frame shows this. Its Stop button is the emergency stop.
- During desktop control the agent always works with Qwen 3.8 27B at STACKIT in Germany, whichever model is selected in the chat.
Emergency stop
Ctrl+Shift+F12 immediately stops everything the agent is doing: browser actions, desktop control and running answers. The Stop everything button and Stop on the red frame do the same. Only a newly typed message lifts the block again. If the shortcut is already taken on your computer, the program tells you so and only names the button.
Where your data goes
The program runs on your computer, the language models do not. Everything the agent reads for a task goes to the selected model as part of the request. That includes content from files and web pages, and with desktop control also window contents and screenshots.
- Model calls run through
sovrgpt.comto the selected model. By default Automatisch (automatic) is selected: SovrGPT picks for each task among the models your organisation allows. The model overview names the operators of the models. - Web search sends the search term through
sovrgpt.comto Brave Search in the USA. Pages the agent reads are fetched bysovrgpt.comand passed to the agent as text. - The program does not write screenshots to disk. It keeps only the latest one per chat in memory and sends it to the model with the request.
- The program sends no usage data to the goose project or other third parties.
- At startup the program downloads a public model list from
models.dev. No content and no account data are sent, only the usual connection data. If your firewall blocks the address, the program keeps working unchanged. - Office files and images are created on
sovrgpt.comand afterwards also stay in your SovrGPT account, as in the web chat. - Dictation and live voice run through
sovrgpt.comto speech recognition and speech output in the EU (see Voice). - Your conversation histories are stored locally in your user folder and, since syncing, also in the SovrGPT EU database in the organisation of your key, like your web chats. Tool output is shortened, recognisable keys and passwords are removed beforehand, local file paths stay (see One chat list for web and desktop).
- The key is stored encrypted in your user account. The agent's tools do not get to see it; they talk to a local relay. It only lets through model calls and the approved SovrGPT tools, never your web chats and never the voice features: the program sends recordings and speech output itself. This does not protect against malware deliberately running under your user account.
Voice
You can dictate to the agent or talk to it. Both run through your SovrGPT account: speech recognition and speech output work in the EU, and the same prices and limits apply as for voice in the API. Speech recognition is billed by recording length, speech output by characters. The spoken language is the program's language, German or English.
Dictation
Click the microphone in the input field and speak. The recognised text appears in the input field; you read it and send it yourself. Dictation is switched on by default. You can switch it off under Settings → Chat in the Voice input via field.
Live voice
With the live voice button next to the input field you talk to the agent as on the phone: you say a task, it works on it and reads its answer aloud. In a voice conversation it answers more briefly and without tables; what it reads aloud also appears in the chat.
- Taking turns: while the program is speaking, it does not listen. Wait until the answer has finished, or interrupt it with the button.
- You confirm questions in the window. Before writing steps the agent asks as usual; this cannot be allowed by voice.
- While live voice is running, dictation is blocked, and vice versa. The microphone is never used by both at once.
Microphone
The program only requests the microphone, never the camera. If the microphone does not respond, check under Windows Settings → Privacy & security → Microphone that desktop apps may access the microphone.
If dictation or live voice is missing although you are signed in, your key probably comes from an older version. Click Reconnect (see Signing in).
Models
At the bottom of the input field you choose between all approved models without cold start. The list and the prices come from your account at startup. By default it shows Automatisch (automatic): SovrGPT picks a suitable model for each task and keeps it for the whole chat; the bar then reads, for example, "Automatisch · Qwen 3.8 27B". A model you choose yourself stays selected. If your organisation has a model allow list, it applies here too. The selection in the program may be smaller than in the web chat.
One chat list for web and desktop
Your chats in the program and on sovrgpt.com form one list. The program syncs them by itself: at
start, regularly in the background and when you bring the window back to the front. There is no
button for it.
- Web chats in the program: your web chats appear in the program's chat list. You can continue them there; what you write appears on the web in the same chat.
- Desktop chats on the web: chats from the program appear on the web marked “Desktop”. You can read and continue them there; the answer comes back to the program.
- What is synced: your messages and the answers. Tool output is shortened, recognisable keys and passwords are removed beforehand. Local file paths stay; syncing does not upload the files themselves.
- Which organisation: the organisation the program is connected to. Only your own chats are synced, never those of other members.
- Deleting hides: if you delete a chat in the program, it is hidden (archived) on the web, not deleted. If many chats disappear from the computer at once (for example after the chat database was replaced), the program does not hide them and tells you; everything stays on the web. If you delete a chat on the web, it stays on the computer and is marked as existing only on this computer.
- On the first sync the most recent 500 chats of each side appear; older ones appear as soon as you continue them.
- While an answer is running on the web, the program waits with its part until the next sync. If a chat is open in the program while it continues on the web, the program offers to take over the new messages.
Syncing calls no model and costs nothing. If the program shows Reconnect, your desktop chats only go to the web after signing in again; web chats arrive before that.
Extensions
The Extensions page shows the agent's sets of tools: SovrGPT tools, Files and commands and Browser. There you switch them on or off for new chats; in the input field you switch them for the current chat. You switch desktop control only under Settings → App (see Desktop control).
Custom extensions cannot be added, because an extension could start any program on your computer.
The program therefore does not open links of the form sovrgpt://extension?…; it only shows a
notice. Extensions you added yourself in an older version stay in the configuration but no longer
start.
Recipes
Recipes, saved tasks with their own tools, are not available in SovrGPT Desktop. The program does not
open links of the form sovrgpt://recipe?…; it only shows a notice.
Project hints
Place a .goosehints file in a folder to give the agent lasting hints for that folder, such as
conventions or important paths. The file name comes from the underlying open-source project.
Signing out and uninstalling
Settings → Models → Sign out on this computer removes the key from the computer. To disable it entirely, also revoke it under Settings → API keys.
Uninstall through Windows Settings → Apps. Your conversation histories remain under
%APPDATA%\SovrGPT Desktop until you delete the folder yourself. Delete logins in the agent's
browser beforehand under Settings → App → SovrGPT browser.
Basis
SovrGPT Desktop is a separate edition of the open-source project
goose (Apache License 2.0) and not an official goose product.
Licence texts and the list of our changes are in the program folder under resources.