|
1 | | -OriginZero Flow Builder Project Documentation |
| 1 | + |
| 2 | + |
| 3 | +# OriginZero - Collaborative low-code workflow automation tool |
| 4 | + |
| 5 | +Originzero is a collaborative low-code workflow automation tool designed to empower individuals and businesses to create their own workflows without needing any coding skills. Users can easily build workflows using a drag-and-drop method to add and connect nodes. These nodes operate concurrently (and in parallel when needed), significantly enhancing performance. |
| 6 | + |
| 7 | +Originzero also allows teams to create their own workspaces, enabling members to collaborate on workflows based on their permission levels. This promotes a collaborative environment where team members can work together efficiently. |
| 8 | + |
| 9 | +**The tool features an extendable node system, with a goal to continuously expand the number of nodes through contributions from the core team and the community.** |
| 10 | + |
| 11 | + |
| 12 | + |
| 13 | +## 🏁 Quick Start |
| 14 | + |
| 15 | +Check out our [wiki page](https://github.com/originzero-io/originzero/wiki/Getting-Started) for full instructions on getting started. |
| 16 | + |
| 17 | +1. Clone the code: |
| 18 | + |
| 19 | + git clone https://github.com/originzero-io/originzero.git |
| 20 | + cd originzero |
| 21 | + |
| 22 | +2. Install the dependencies |
| 23 | + |
| 24 | + npm install |
| 25 | + |
| 26 | +3. Run |
| 27 | + |
| 28 | + npm start |
| 29 | +5. Open |
| 30 | + |
| 31 | + http://localhost:5173 |
| 32 | + |
| 33 | + |
| 34 | +## 📂 Directory structure |
| 35 | + |
| 36 | +Originzero is split up in different modules which are all in a single mono repository. |
| 37 | + |
| 38 | +The most important directories: |
| 39 | + |
| 40 | +- [/packages](/packages) - All originzero modules |
| 41 | +- [/packages/editor](/packages/editor) - React frontend components |
| 42 | +- [/packages/api-gateway](/packages/api-gateway) - Central api gateway to access all APIs safely and efficiently |
| 43 | +- [/packages/entity-api](/packages/entity-api) - All entities like workspaces, projects, flows, users, etc. |
| 44 | +- [/packages/flow-runtime](/packages/flow-runtime) - Runtime algorithm that handles flow execution, concurrency, and parallelism, and also includes nodes. |
| 45 | + - **Contact us before starting on any changes here** |
| 46 | +- [/packages/dockerize-api](/packages/dockerize-api) - A package that creates a container for each flow created |
| 47 | +- [/packages/math-service](/packages/math-service) - Allows the Calculate node to handles complex mathematical operations |
| 48 | + |
| 49 | +## ⚒️ Requirements |
| 50 | +1. [Node.js](https://nodejs.org/en/download/package-manager) 18 and above |
| 51 | +2. [Typescript](https://www.typescriptlang.org/download/) 5 and above |
| 52 | +3. [Lerna](https://lerna.js.org/docs/getting-started) |
| 53 | +4. [Python](https://www.python.org/downloads/) 3 and above |
| 54 | +5. [Docker](https://www.docker.com/products/docker-desktop/) |
| 55 | +6. [Mongodb](https://www.mongodb.com/try/download/community-kubernetes-operator) |
| 56 | + |
| 57 | +## 📚 Documentation |
| 58 | + |
| 59 | +The official documentation can be found on [here](https://github.com/originzero-io/originzero/wiki). |
| 60 | + |
| 61 | +For further help, or general discussion, please use the [Github discussions](https://github.com/orgs/originzero-io/discussions) or [discord server](https://discord.gg/VyQD9QAq). |
| 62 | + |
| 63 | +## 💫 Contributing |
| 64 | +Before raising a pull-request, please read our |
| 65 | +[contributing guide](/CONTRIBUTING.md). |
| 66 | + |
| 67 | +This project adheres to the [Contributor Covenant 1.4](http://contributor-covenant.org/version/1/4/). |
| 68 | + By participating, you are expected to uphold this code. Please report unacceptable |
| 69 | + behavior to any of the project's core team at info@originzero.io. |
| 70 | + |
| 71 | +## 📋 License |
| 72 | + |
| 73 | +This project is under [the Apache 2.0 license](LICENSE). |
0 commit comments