Skip to content
Machine Docs Logo Machine Docs

Machine Docs

What you get

  • 3 lines of YAML, no infrastructure to manage. Add machine to runs-on: and that’s it.
  • 5 NVIDIA GPU types (T4G, T4, L4, A10G, L40S) plus AWS Trainium and Inferentia2 accelerators.
  • CPU runners from 2 to 64 vCPUs in X64 (Intel/AMD) and ARM64 (Graviton) flavors.
  • Per-minute billing in real dollars. No credits. Cold start ~1 minute. You only pay for runtime.
  • Configurable storage — every runner gets a 100 GB gp3 EBS volume by default, scalable to 16 TB with custom IOPS and throughput.
  • Instance metrics collected by default and rendered as sparkline charts on the dashboard.
  • Spot pricing saves 70–90% versus on-demand. Combine with checkpointing for resilient long jobs.

Quickstart

  1. Sign up for a Machine account — new accounts get $10 of free compute.

  2. Install the Machine GitHub App on your account or organization.

  3. Enable self-hosted runners for the repos you want Machine to run jobs for.

  4. Add this to a workflow file (e.g. .github/workflows/test.yml):

    jobs:
      gpu-job:
        runs-on: [machine, gpu=t4g, tenancy=spot]
        steps:
          - uses: actions/checkout@v4
          - run: nvidia-smi

  5. Push the workflow. Watch the job pick up a Machine runner in your Actions tab.

This minimal demo runs in about a minute on a T4G spot runner — costs about $0.004 per run.

For a full walkthrough see the Quickstart guide.

How Machine fits with GitHub Actions

Machine architecture: Developer push → GitHub Actions → Machine Provisioner → AWS instance → registers as ephemeral self-hosted runner → job runs → logs and artifacts

When you add runs-on: [machine, ...] to a job, GitHub Actions hands the job to the Machine Provisioner. We launch a fresh AWS instance matching your labels, the GitHub Actions Runner agent inside the VM dials home and registers itself as an ephemeral self-hosted runner attached to your org or repo, GitHub dispatches the job, and the runner shuts down when the job finishes. You only pay for the seconds the runner was up.

Free tier

New accounts get $10 of free compute to try Machine — enough for about 58 hours of T4G GPU time at spot rates ($0.004/min), or several thousand minutes of CPU time. Sign up and add a workflow.

Where to go next