CI Runnerscirunners.org
Runner profile · Open-source project

Tartelet

Answer in brief

Open-source macOS app that runs up to two GitHub Actions runners in ephemeral Tart virtual machines on a single Mac. Tartelet is an MIT-licensed desktop app for teams that want a pair of ephemeral GitHub Actions runners on each Apple silicon Mac they own.

By the CI Runners editors · Updated

Overview

Tartelet is a macOS app that launches self-hosted GitHub Actions runners inside virtual machines managed by Tart. For each runner it clones a VM, boots it, runs a setup script that downloads GitHub’s runner application and registers it, and waits for a job. When the job finishes the runner removes itself, the VM is shut down and deleted, and the cycle starts again.

The app manages up to two VMs on one host, which its README gives as the limit of Apple’s Virtualization framework, and reports that recreating a VM takes about 25 to 30 seconds. Runners register through a GitHub App at organisation or repository scope, with the private key kept in the host’s keychain. The project is MIT-licensed and now lives under the Framna Denmark GitHub organisation, having started at shapehq/tartelet.

Notable

  • June 13, 2025: release 0.12.0 published on GitHub
  • The repository’s most recent push recorded by GitHub is dated February 10, 2026
  • The README’s performance figures were last updated in January/February 2023

Tartelet specifications

AttributeDetails
CI systemsGitHub Actions
Operating systemsmacOS
Architecturesarm64
DeploymentOpen-source project
Where it can runBare metal
IsolationEach runner runs in a Tart virtual machine that is cloned before a job and shut down and deleted after it
Fresh environment per jobYes
HardwareAn Apple silicon Mac that you supply; the maintainers’ own figures come from a 2020 Mac mini M1 with 16 GB of memory.
Performance (vendor claim)The maintainers report jobs running 3 to 4 times faster on a Mac mini M1 than on GitHub’s runners, measured in January/February 2023 (project claim)
Runner sizesNot documented
CachingNot documented
Docker layer cachingNot documented
GPUNot documented
ConcurrencyUp to two virtual machines per host, which the README gives as the maximum Apple’s Virtualization framework allows
Job limitsNot documented
Static IPsNot documented
SSH into running jobsNot documented
ObservabilityNot documented
SetupInstall Tart and Tartelet on the host Mac, create a GitHub App with self-hosted runner permissions, build a Tart VM image, and select both in Tartelet’s settings.
Example labelNot documented
PricingFree and MIT-licensed; you supply the Mac.
Free tierNot documented
ComplianceNot documented
RegionsWherever your Mac runs
Open sourceYes (MIT)
Company headquartersNot documented

Facts from Tartelet’s public documentation, verified November 22, 2026. Performance figures are vendor claims.

Strengths and trade-offs

Reasons to choose it

  • You want two parallel GitHub Actions runners on one Mac, each job in a VM that is recreated afterwards
  • You prefer a desktop app with settings panes to writing orchestration config
  • You want MIT-licensed tooling with no licence fee
  • You already build VM images with Tart

Trade-offs

  • Supports GitHub Actions only
  • At most two virtual machines per host
  • Requires Tart to be installed separately on the host
  • Running two VMs in parallel made jobs about 12% slower than one VM in the maintainers’ tests

Good fit for: Small teams on GitHub Actions that want two isolated, ephemeral runners per Mac managed from a desktop app.

Use cases Tartelet fits

How Tartelet compares

RunnerCI systemsRuns onDeploymentIsolationPriceLargest runnerDocker layer cacheGPUOpen sourceCompany HQ
TarteletGitHub ActionsmacOS, arm64Self-hostedTart VMFree software + your infrastructureSet by your infrastructureNot documentedNot documentedYesNot documented
TartGitLab CI, Buildkite, GitHub ActionsmacOS, Linux, arm64Your cloud or hardwareApple Virtualization VMNot documentedSet by your infrastructureNot documentedNot documentedNoUnited States
OrkaGitHub Actions, GitLab CI, Buildkite, Jenkins, Azure Pipelines, TeamCitymacOS, arm64Your cloud or hardwaremacOS VMFrom $109/mo per hosted Mac mini (Orka by quote)Set by your infrastructureNot documentedNot documentedNoUnited States
GetMacGitHub Actions, GitLab CI, BuildkitemacOS, arm64Vendor-hostedmacOS VM$0.012/min (macOS M4, Developer plan)Not documentedNot documentedNot documentedNoLithuania
Actions Runner Controller (ARC)GitHub ActionsLinux, WindowsSelf-hostedKubernetes podFree software + your infrastructureSet by your infrastructureNot documentedNot documentedYesUnited States
GitHub-hosted runnersGitHub ActionsLinux, macOS, Windows, x64, arm64Platform-hostedFresh VM$0.006/min96 vCPU / 384 GBNot documentedYesNoUnited States

Head-to-head: Tart vs Tartelet

See all Tartelet alternatives →

Frequently asked questions

What is Tartelet?
Open-source macOS app that runs up to two GitHub Actions runners in ephemeral Tart virtual machines on a single Mac. Tartelet is an MIT-licensed desktop app for teams that want a pair of ephemeral GitHub Actions runners on each Apple silicon Mac they own.
Which CI systems does Tartelet work with?
Tartelet runs jobs for GitHub Actions, on macOS and arm64.
How does Tartelet isolate jobs?
Tartelet documents its isolation as: Each runner runs in a Tart virtual machine that is cloned before a job and shut down and deleted after it. Each job gets a fresh environment that is discarded afterwards.
Is Tartelet open source?
Yes (MIT). It can be self-hosted.
How much does Tartelet cost?
Free and MIT-licensed; you supply the Mac. Check the official pricing page for current rates.
How do you set up Tartelet?
Install Tart and Tartelet on the host Mac, create a GitHub App with self-hosted runner permissions, build a Tart VM image, and select both in Tartelet’s settings.
How fast is Tartelet?
The maintainers report jobs running 3 to 4 times faster on a Mac mini M1 than on GitHub’s runners, measured in January/February 2023 (project claim). Speed figures are the provider’s own and depend on the workload.
Does Tartelet support ARM64 runners?
Yes, Tartelet documents arm64 runners (macOS).
How many jobs can run at once on Tartelet?
Up to two virtual machines per host, which the README gives as the maximum Apple’s Virtualization framework allows.
Where do Tartelet runners run?
Wherever your Mac runs.
What are the alternatives to Tartelet?
Common alternatives include Tart, Orka, GetMac, Actions Runner Controller (ARC), GitHub-hosted runners. See Tartelet alternatives for a full comparison.

Sources

  1. github.com/framna-dk/tartelet
  2. github.com/framna-dk/tartelet/blob/main/README.md
  3. github.com/framna-dk/tartelet/wiki/Configuring-Tartelet
  4. github.com/framna-dk/tartelet/wiki/Installing-Tartelet
  5. github.com/framna-dk/tartelet/releases

Check before you rely on it. Products change quickly, and this page reflects public documentation as of November 22, 2026. Confirm anything that matters in the provider’s own documentation.

Cite this page

CI Runners. (2026). Tartelet. cirunners.org. Last reviewed November 22, 2026. https://cirunners.org/runners/tartelet/