<p align="center"> <a href="https://actionsflow.github.io" rel="noopener"> <img width=200px height=200px src="https://raw.githubusercontent.com/actionsflow/actionsflow/main/docs/assets/logo.svg" alt="Project logo"></a> </p> <h1 align="center">Actionsflow</h1> <div align="center">

<br>

</div>

<p align="center"> <strong>The free <a href="https://ifttt.com/">IFTTT</a>/<a href="https://zapier.com/">Zapier</a> alternative for developers to automate their workflows based on GitHub actions, option to run self-hosted without GitHub as well</strong> <br> <br> </p>

😁 About

Actionsflow helps you automate workflows - it's a free IFTTT/Zapier alternative for developers. With Actionsflow you can connect your favorite apps, data, and APIs, receive notifications of actions as they occur, sync files, collect data, and more. We implemented it based on Github actions, and you use a YAML file to build your workflows. The configuration format is the same as Github actions, which makes it easy for you to get going if you've explored Github actions before. You can also use any Github actions as your job's steps.

You can learn more about the core concepts of Actionsflow here.

If you want a lighter, simpler workflow that doesn't rely on Github Actions, consider Denoflow, another workflow tool made by me, based on Deno with YAML , you can try it at an online playground

🔥 Features

Totally Free! Actionsflow is based on Github actions. To run an Actionsflow workflow, all you need to do is create a repository from the Actionsflow template repository, or, you can also deploy a self-hosted version.
Leverage Community Triggers. You can use community-provided triggers like Slack, RSS, Webhook, Typeform, Email, Reddit, NPM, Telegram, Twitter, etc. You can also easily create your own triggers.
Support Almost ALL Actions of Github Actions. Actionsflow uses act (a tool for running GitHub Actions locally) to run the jobs on your workflow file. With these awesome Github actions, you can connect with IFTTT, Zapier, or other services like Slack, Telegram, Facebook, Twitter, Line, etc.
Support Self-Hosted You can run Actionsflow based on both GitHub Repository or a self-hosted version.
Simple Workflow Configuration. The Actionsflow configuration format is the same as Github actions. If you've written a Github actions file before, you'll find defining an Actionsflow workflow file really easy.
Run triggers every 5 minutes. The workflow can check and run every 5 minutes based on Github actions scheduled events.
Support complex workflows. With Actionsflow you can make complex advanced workflows. Actionsflow provides a MongoDB query language for you to filter your data as you want.

🎓 Documentation

Full documentation for Actionsflow lives on the website.

You can also view it on Github if you prefer.

👀 How Actionsflow works

Actionsflow uses Github Actions' repository_dispatch event and scheduled event every 5 minutes to run Actionsflow triggers. Those triggers generate result items, which are cached and deduplicated, generating a standard Github actions workflow file with the trigger result. Finally, the workflows are executed using act (a tool for running GitHub Actions locally).

To learn more about how Actionsflow works, please see Core Concepts of Actionsflow.

🏁 Getting Started

For self-hosted version please see here

Create a public Github repository by using this link.

A typical Actionsflow repository structure looks like this:

├── .github
│   └── workflows
│       └── actionsflow.yml
├── .gitignore
├── README.md
└── workflows
│   └── rss.yml
│   └── webhook.yml
└── package.json

Uncomment .github/workflows/actionsflow.yml schedule event
```
on:
  schedule:
    - cron: "*/15 * * * *"
```
Note: To prevent abuse, by default, the schedule is commented, please modify the schedule time according to your own needs, the default is once every 15 minutes. Learn more about schedule event, please see here

Create your workflow files inside the workflows directory

A typical workflow file rss.yml looks like this:

on:
  rss:
    url: https://hnrss.org/newest?points=300&count=3
jobs:
  request:
    name: Make a HTTP Request
    runs-on: ubuntu-latest
    steps:
      - name: Make a HTTP Request
        uses: actionsflow/axios@v1
        with:

Actionsflow

Install / Use