Install
One line is enough on any of the three systems. The other two paths are there for a reader who has an agent, or who wants to see every step.
Pick your path
MacOne line in Terminal. Finds or installs Python, downloads the desk into a GreekSoup folder in your home folder, starts it, opens it.About a minute
WindowsOne line in PowerShell, written from Microsoft's documented commands.About a minute
LinuxThe same line as the Mac, with a systemd user service to keep it running.About a minute
With an AI agentDownload the folder, open it in Claude Code, Codex, Kimi Code or Grok Build, paste one instruction.About twenty minutes
From sourceClone, make an environment, install what it needs, run the server.By hand
What the one-line install does, in order
- Finds Python on your computer, and installs it if it is missing (from python.org on a Mac, with winget on Windows; on Linux it tells you the package to install).
- Downloads the desk into a folder called
GreekSoupin your home folder. - Installs what the desk needs into that folder. The only thing it puts outside the folder is the small start-at-login entry in step 5.
- Copies the settings file into place, empty. Keys come later, on the Settings screen.
- Sets the desk to start with your computer and to come back by itself if it stops.
- Starts it and opens it in your browser at
http://localhost:8765.
Run the same line again later and it only starts the desk; new versions arrive through the strip inside the desk.
What it needs
A Mac, a Windows PC or a Linux computer that you leave on while you work, Python 3.10 or newer (found or installed for you), and a browser. The desk itself takes under 100 MB; the caches it builds take a few hundred more over time.
After the install
- Keep it running: what the always-on service is and the two files that switch it.
- Updates: the strip, the one click, what it keeps, and how to go back.
- Back up: one zip of everything that is yours.
- Uninstall: one double-click, nothing left behind.
- What it talks to: every outbound request, and what it never sends.
- If something is wrong: symptom first, and the one check that hands the rest to your agent.
- The page is blank: the four things to try, in order.