{"id":33175204,"url":"https://github.com/NitorCreations/nFlow","last_synced_at":"2025-11-20T20:02:09.314Z","repository":{"id":13759019,"uuid":"16453755","full_name":"NitorCreations/nflow","owner":"NitorCreations","description":"Embeddable JVM-based workflow engine with high availability, fault tolerance, and support for multiple databases. Additional libraries are provided for visualization and REST API.","archived":false,"fork":false,"pushed_at":"2025-05-25T18:12:03.000Z","size":32352,"stargazers_count":217,"open_issues_count":24,"forks_count":44,"subscribers_count":51,"default_branch":"master","last_synced_at":"2025-07-24T17:07:16.461Z","etag":null,"topics":["java","nflow","orchestrating-processes","saga-pattern","workflow","workflow-automation","workflow-engine"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/NitorCreations.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2014-02-02T11:56:18.000Z","updated_at":"2025-07-02T08:34:25.000Z","dependencies_parsed_at":"2023-02-18T16:32:34.995Z","dependency_job_id":"b52ff8fb-4ac0-4344-98c3-060e65003aa3","html_url":"https://github.com/NitorCreations/nflow","commit_stats":{"total_commits":2685,"total_committers":29,"mean_commits":92.58620689655173,"dds":0.7016759776536312,"last_synced_commit":"f884a0798fdca00fa63aee926f78cbf31d65a663"},"previous_names":[],"tags_count":64,"template":false,"template_full_name":null,"purl":"pkg:github/NitorCreations/nflow","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NitorCreations%2Fnflow","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NitorCreations%2Fnflow/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NitorCreations%2Fnflow/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NitorCreations%2Fnflow/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NitorCreations","download_url":"https://codeload.github.com/NitorCreations/nflow/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NitorCreations%2Fnflow/sbom","scorecard":{"id":101977,"data":{"date":"2025-08-11","repo":{"name":"github.com/NitorCreations/nflow","commit":"0599c6c829d103cecb416f6926c2bc1454ccd6f8"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":3.8,"checks":[{"name":"Maintained","score":1,"reason":"1 commit(s) and 1 issue activity found in the last 90 days -- score normalized to 1","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Code-Review","score":4,"reason":"Found 8/20 approved changesets -- score normalized to 4","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Token-Permissions","score":8,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: topLevel 'security-events' permission set to 'write': .github/workflows/build.yaml:15","Info: topLevel 'contents' permission set to 'read': .github/workflows/build.yaml:13","Warn: topLevel 'checks' permission set to 'write': .github/workflows/build.yaml:14","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Binary-Artifacts","score":5,"reason":"binaries present in source code","details":["Warn: binary detected: nflow-examples/spring-boot/bare-minimum/gradle/gradle/wrapper/gradle-wrapper.jar:1","Warn: binary detected: nflow-examples/spring-boot/bare-minimum/maven/.mvn/wrapper/maven-wrapper.jar:1","Warn: binary detected: nflow-examples/spring-boot/full-stack-kotlin/gradle/wrapper/gradle-wrapper.jar:1","Warn: binary detected: nflow-examples/spring-boot/full-stack/gradle/gradle/wrapper/gradle-wrapper.jar:1","Warn: binary detected: nflow-examples/spring-boot/full-stack/maven/.mvn/wrapper/maven-wrapper.jar:1"],"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"License","score":9,"reason":"license file detected","details":["Info: project has a license file: EUPL-v1.1-Licence.txt:0","Warn: project license file does not contain an FSF or OSI license."],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yaml:45: update your workflow using https://app.stepsecurity.io/secureworkflow/NitorCreations/nflow/build.yaml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yaml:47: update your workflow using https://app.stepsecurity.io/secureworkflow/NitorCreations/nflow/build.yaml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yaml:59: update your workflow using https://app.stepsecurity.io/secureworkflow/NitorCreations/nflow/build.yaml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yaml:61: update your workflow using https://app.stepsecurity.io/secureworkflow/NitorCreations/nflow/build.yaml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yaml:67: update your workflow using https://app.stepsecurity.io/secureworkflow/NitorCreations/nflow/build.yaml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/build.yaml:74: update your workflow using https://app.stepsecurity.io/secureworkflow/NitorCreations/nflow/build.yaml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yaml:79: update your workflow using https://app.stepsecurity.io/secureworkflow/NitorCreations/nflow/build.yaml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yaml:93: update your workflow using https://app.stepsecurity.io/secureworkflow/NitorCreations/nflow/build.yaml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yaml:95: update your workflow using https://app.stepsecurity.io/secureworkflow/NitorCreations/nflow/build.yaml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/build.yaml:107: update your workflow using https://app.stepsecurity.io/secureworkflow/NitorCreations/nflow/build.yaml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yaml:113: update your workflow using https://app.stepsecurity.io/secureworkflow/NitorCreations/nflow/build.yaml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yaml:25: update your workflow using https://app.stepsecurity.io/secureworkflow/NitorCreations/nflow/build.yaml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yaml:27: update your workflow using https://app.stepsecurity.io/secureworkflow/NitorCreations/nflow/build.yaml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/build.yaml:35: update your workflow using https://app.stepsecurity.io/secureworkflow/NitorCreations/nflow/build.yaml/master?enable=pin","Info:   0 out of  11 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   3 third-party GitHubAction dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"SAST","score":9,"reason":"SAST tool detected but not run on all commits","details":["Info: SAST configuration detected: CodeQL","Warn: 17 commits out of 19 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Vulnerabilities","score":0,"reason":"31 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: GHSA-j288-q9x7-2f5v","Warn: Project is vulnerable to: GHSA-4gc7-5j7h-4qph","Warn: Project is vulnerable to: GHSA-4wp7-92pw-q264","Warn: Project is vulnerable to: GHSA-27hp-xhwr-wr2m","Warn: Project is vulnerable to: GHSA-3p2h-wqq4-wf4h","Warn: Project is vulnerable to: GHSA-5j33-cvvr-w245","Warn: Project is vulnerable to: GHSA-7w75-32cg-r6g2","Warn: Project is vulnerable to: GHSA-83qj-6fr2-vhqg","Warn: Project is vulnerable to: GHSA-fccv-jmmp-qg76","Warn: Project is vulnerable to: GHSA-ff77-26x5-69cr","Warn: Project is vulnerable to: GHSA-g8pj-r55q-5c2v","Warn: Project is vulnerable to: GHSA-h2fw-rfh5-95r3","Warn: Project is vulnerable to: GHSA-h3gc-qfqq-6h8f","Warn: Project is vulnerable to: GHSA-q3mw-pvr8-9ggc","Warn: Project is vulnerable to: GHSA-qppj-fm5r-hxr3","Warn: Project is vulnerable to: GHSA-r6j3-px5g-cq3x","Warn: Project is vulnerable to: GHSA-wc4r-xq3c-5cf3","Warn: Project is vulnerable to: GHSA-wm9w-rjj3-j356","Warn: Project is vulnerable to: GHSA-v682-8vv8-vpwr","Warn: Project is vulnerable to: GHSA-rc42-6c7j-7h5r","Warn: Project is vulnerable to: GHSA-2rmj-mq67-h97g","Warn: Project is vulnerable to: GHSA-2wrp-6fg6-hmc5","Warn: Project is vulnerable to: GHSA-6r3c-xf4w-jxjm","Warn: Project is vulnerable to: GHSA-ccgv-vj62-xf9h","Warn: Project is vulnerable to: GHSA-hgjh-9rj2-g67j","Warn: Project is vulnerable to: GHSA-cx7f-g6mp-7hqm","Warn: Project is vulnerable to: GHSA-g5vr-rgqm-vf78","Warn: Project is vulnerable to: GHSA-v94h-hvhg-mf9h","Warn: Project is vulnerable to: GHSA-mjmj-j48q-9wg2","Warn: Project is vulnerable to: GHSA-v6h2-p8h4-qcjw","Warn: Project is vulnerable to: GHSA-fjxv-7rqg-78g4"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-15T10:19:50.069Z","repository_id":13759019,"created_at":"2025-08-15T10:19:50.069Z","updated_at":"2025-08-15T10:19:50.069Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":285503668,"owners_count":27182913,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-11-20T02:00:05.334Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["java","nflow","orchestrating-processes","saga-pattern","workflow","workflow-automation","workflow-engine"],"created_at":"2025-11-16T02:00:36.117Z","updated_at":"2025-11-20T20:02:09.305Z","avatar_url":"https://github.com/NitorCreations.png","language":"Java","readme":"#\n\n![nFlow](./nflow-documentation/nflow_logo.svg#gh-light-mode-only)\n![nFlow](./nflow-documentation/nflow-logo-dark.svg#gh-dark-mode-only)\n\nnFlow is a battle-proven solution for orchestrating business processes. Depending on where you're coming from, you can view nFlow as any of the following:\n\n* Microservices orchestrator (as in [Saga-pattern](https://microservices.io/patterns/data/saga.html))\n* Guaranteed delivery computing\n* Replacement for [business process engine](https://www.techopedia.com/definition/26689/business-process-engine-bpe)\n* Persistent [finite-state machine](https://en.wikipedia.org/wiki/Finite-state_machine)\n\nnFlow has been under development since 2014-01-14 and version 1.0.0 was released on 2014-09-13.\n\n![Build status](https://github.com/NitorCreations/nflow/actions/workflows/build.yaml/badge.svg?event=push)\n\n## Key Features\n\n* Non-declarative \u0026mdash; workflows are defined as code\n* Visualization \u0026mdash; workflows can be visualized in [nFlow Explorer](https://github.com/NitorCreations/nflow/tree/master/nflow-explorer)\n* Embeddable \u0026mdash; usually embedded as a library, but a standalone server is also provided\n* High availability \u0026mdash; the same workflows can be processed by multiple deployments\n* Fault tolerant \u0026mdash; automatic recovery if runtime environment crashes\n* Atomic state updates \u0026mdash; uses and requires a relational database for atomic state updates and locking\n* Multiple databases supported \u0026mdash; PostgreSQL, MySQL, MariaDB, Oracle, Microsoft SQL Server, DB2, H2\n* Open Source under EUPL\n\n## \u003ca name=\"getting-started\"\u003e\u003ca name=\"one-minute-guide\"\u003e\u003c/a\u003e\u003c/a\u003e1 Minute Guide for Getting Started\n\nCreate a Maven project. Add the following to your `pom.xml`. nFlow is available in the [Maven Central Repository](https://search.maven.org/search?q=g:io.nflow).\n\n```xml\n\u003cdependency\u003e\n  \u003cgroupId\u003eio.nflow\u003c/groupId\u003e\n  \u003cartifactId\u003enflow-jetty\u003c/artifactId\u003e\n  \u003cversion\u003e10.0.1\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\nCreate a class for starting nFlow in embedded Jetty using H2 memory database.\n\n```java\nimport io.nflow.jetty.StartNflow;\n\npublic class App {\n  public static void main(String[] args) throws Exception {\n    new StartNflow().startJetty(7500, \"local\", \"\");\n  }\n}\n```\n\nThat's it! Running `App` in your favourite IDE will start nFlow server though without any workflow definitions.\n\nPoint your browser to [http://localhost:7500/nflow/ui/doc/](http://localhost:7500/nflow/ui/doc/) and you can use interactive online documentation for the nFlow REST API.\n\nPoint your browser to [http://localhost:7500/nflow/ui/explorer/](http://localhost:7500/nflow/ui/explorer/) and you can use nFlow Explorer.\n\nSee [Getting started section](https://github.com/NitorCreations/nflow/wiki/Getting-Started) for instruction on creating your own workflow definitions.\n\n## \u003ca name=\"components\"\u003e\u003c/a\u003eOk, I'm interested\n\nFor a more thorough getting started guide, configurations, license information etc. checkout the [nFlow wiki pages](https://github.com/NitorCreations/nflow/wiki)! You can also look into a short [slide deck](https://github.com/NitorCreations/nflow/raw/master/nflow-documentation/presentations/nflow_presentation.pdf).\n\nDiscussion and questions are welcome to our forum [nflow-users](https://groups.google.com/forum/#!forum/nflow-users) in Google Groups.\n\nFor commercial support, contact [Nitor sales](mailto:sales@nitor.com).\n","funding_links":[],"categories":["Library (embedded usage)"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FNitorCreations%2FnFlow","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FNitorCreations%2FnFlow","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FNitorCreations%2FnFlow/lists"}