Skip to content
gunkslab

Project

Welcome email

What someone gets after confirming their signup to the gunkslab mailing list. It’s sent once, from news@gunkslab.com as “gunkslab”, and replies go to a person.

The third paragraph has two versions. The first goes out while the code is in early access. The second replaces it the day the repository opens. Nothing else changes between them.

The email

Subject: You’re on the gunkslab list

Thanks for signing up.

gunkslab Desk runs a small fleet of simulated robots on your computer. There’s a simulator, a station that tells the bots where to go, and a page in your browser where you watch them and drive them around. It all runs in containers on your machine, and you don’t need an account to run it.

While the code is in early access:

The code isn’t public yet. If you want in now, you’ll need a GitLab account, and a free one is fine. Ask for it here and I’ll add you to the project: https://gitlab.com/gunkslab/desk-issues/-/issues/new?issuable_template=early-access Tick Turn on confidentiality before you create it, so your request stays private.

Once the repository is public:

The code is on GitLab. Get it with:

git clone https://gitlab.com/gunkslab/gunkslab.git
cd gunkslab

The install page walks you through the rest for your OS. It takes about 15 minutes: https://gunkslab.com/docs/get-started/install

Then run ./gunkslab up in the repo folder. A page opens with two bots on a desk. Pick one, click somewhere on the desk, and it drives there.

So far the install has been run on macOS (26 or later, Apple silicon), Ubuntu 24.04 and Rocky Linux 9. Windows 11 and Debian haven’t been tried yet.

One favour. There are ten tutorials, and I want to know the first three work for someone who didn’t write them. Stop the quickstart with ./gunkslab down, then do 01 to 03. They’re about half an hour each: https://gunkslab.com/docs/tutorials

When you finish 03, reply and tell me. If you get stuck, tell me where.

Bugs: reply, or open an issue at https://gitlab.com/gunkslab/desk-issues/-/issues

Thanks for trying it.

Footer, on every email: an unsubscribe link and a postal address.