Run GitHub Actions locally for fast feedback and as a local task runner.
act is a command-line tool that runs GitHub Actions workflows locally on a developer's machine. It solves the problem of needing to commit and push code every time you want to test changes to your workflow files or actions, providing a faster feedback loop. It uses Docker to create containers that simulate GitHub's runner environment.
Developers and DevOps engineers who use GitHub Actions and want to test workflows locally, iterate quickly on CI/CD pipelines, or use actions as a local task runner.
Developers choose act because it dramatically reduces the time to test GitHub Actions workflows, eliminates unnecessary commits, and allows using the same workflow definitions for both local and cloud execution. Its seamless Docker integration ensures environment consistency.
Run your GitHub Actions locally ๐
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
Eliminates the need to commit and push for every workflow test, speeding up development cycles as highlighted in the README's 'Fast Feedback' section.
Configures environment variables and filesystem to mimic GitHub-hosted runners, reducing discrepancies between local and cloud runs.
Leverages Docker to automatically pull or build images defined in workflows, handling dependencies seamlessly without manual setup.
Can replace traditional Makefiles by using existing workflow definitions, offering a unified approach for local task running.
Requires Docker installation and running, which can be a barrier in restricted environments or for teams avoiding containerization.
May not fully replicate all GitHub-hosted runner features, such as specific hardware or cloud integrations, leading to potential false positives in testing.
Setting up custom images or troubleshooting issues requires deep knowledge of both GitHub Actions and Docker, adding overhead.