co3moz/thoric

An agent at work in a real installation, recorded with startrecording. The bar under the desktop names each MCP tool call.
Thoric gives AI agents real Linux desktops. It runs Ubuntu desktops in Docker, on WSL2 or on a Linux host, with GPU acceleration, and its MCP server is built in: an agent connects with a URL and a token, then installs software, runs commands, reads and writes files, sees the screen, clicks and types, records what happened and hands the results back to you. There is no separate MCP container to set up.
The same desktops open in your browser, so you can work in them yourself, save a prepared one as an image and start new containers from it.
The name is a nod to Thor.
## What you can do
Built-in MCP agent integration with 77 tools: commands, files, one-time transfer links for large files, mouse and keyboard, screenshots, text read off the screen, windows, applications, recordings, audio, terminals, accessibility trees, a virtual gamepad and a way to ask a person for help with a CAPTCHA or a sign-in.
MCP servers inside a desktop, declared by a template or registered while it runs from the dashboard, a terminal or the desktop's tray, and MCP endpoints at /mcp/ that give an agent only some containers, some of Thoric's tools and those servers' tools, with a token of their own.
GPU acceleration for Linux graphics applications, verified in WSL2 with an NVIDIA GPU. On a Linux host, NVIDIA GPUs through the NVIDIA Container Toolkit and AMD and Intel GPUs (experimental) are supported but not verified yet; see GPU on a Linux host.
Separate containers with custom settings: resolution, CPU, memory, internet, sound and microphone.
Access, control, change and delete containers from the browser.
Snapshots and images: save a container once and start new ones from it, or build an image from a script.
Composes that ask for values such as an account when a container is created, and run a setup script with them.
Templates: ready-made images from the project wiki, installed with their script shown for review, and an icon for every saved image.
Volumes that keep your files after a container is deleted.
Backup and restore of the whole installation in one file, to move it to another computer with its containers, files, images, volumes and agent endpoints.
Drag and drop uploads into a container.
An interface in English, German, French, Spanish and Turkish, following the browser's language.
Both supplied desktops use Ubuntu 24.04:
| Desktop | When to choose it |
| Lightweight XFCE | A smaller desktop for everyday tools and applications. |
| GNOME | Ubuntu's GNOME Shell session and Yaru theme, with higher resource use. |
Thoric serves one administrator on a local machine or LAN.
## Examples
Examples follows an agent through three tasks, with the tools it calls at each step:
Build an image from a template and start desktops from it, each with an MCP endpoint of its own for another agent.
Test a web app in a real browser and hand back a recording with the server's log.
Ask a person when a CAPTCHA appears with requesthuman, then carry on.
## Getting started
You need Windows 11 or Windows 10 with WSL 2.4.4 or newer. GPU containers also need a Windows GPU driver with WSL support.