# GitHub Actions Compatibility {#github-actions-compatibility}

Takumi Runner provides an execution environment compatible with GitHub-hosted runner's `ubuntu-latest` (`ubuntu-24.04`). This page explains the scope of compatibility and supported labels.

## Compatibility Policy {#compatibility-policy}

The Takumi Runner execution environment is built on the GitHub-hosted runner's `ubuntu-latest` image. The following software is pre-installed, allowing most workflows to run as-is:

- Runtimes (Node.js, Python, Go, Java, Ruby, .NET, etc.)
- Build tools (Make, CMake, Gradle, Maven, etc.)
- Package managers (npm, pip, apt, etc.)
- Version control (Git, Git LFS)
- Container tools (Docker, Docker Compose)
- CLI tools (AWS CLI, Azure CLI, GitHub CLI, etc.)

## Supported `runs-on` Labels {#supported-labels}

Currently, the `takumi-runner` label is provided.

```yaml
jobs:
  build:
    runs-on: takumi-runner
```

The `takumi-runner` label corresponds to the following specs:

| Item                | Value                      |
| ------------------- | -------------------------- |
| Pre-installed tools | `ubuntu-latest` equivalent |
| CPU architecture    | amd64                      |
| vCPU                | 2                          |
| Memory              | 8 GiB                      |

In the future, new labels will be added for expanded instance sizes (more vCPU/memory), additional CPU architectures (arm64, etc.), and base OS changes. The `takumi-runner` label will maintain its current specs, and pre-installed tools will remain `ubuntu-latest` equivalent.

:::note
GitHub-hosted runner labels such as `ubuntu-latest` or `ubuntu-24.04` cannot be used. To use Takumi Runner, specify the `takumi-runner` label.
:::