🚀 Gorax

Modern Workflow Automation Platform

Build, deploy, and manage complex workflows with ease. No code required.

Getting Started • Documentation • Examples • Contributing

---

✨ Features

🎨 Visual Workflow Builder Drag-and-drop interface for creating workflows. No coding required. 🔗 Rich Integrations Connect with Slack, GitHub, Jira, PagerDuty, HTTP APIs, webhooks, and more. ⚡ Real-time Execution Monitor workflows as they run with live updates and detailed logs. 🔀 Loop & Parallel Actions Execute steps in parallel with fork/join semantics and iterate over collections.

🔐 Secure by Default Enterprise-grade security with encrypted credentials (AWS KMS) and RBAC. 👥 Human Tasks Approval workflows with timeout escalation and notification support. 📊 Complete Observability OpenTelemetry tracing, Prometheus metrics, Sentry error tracking. 🗑️ Retention Policies Automatic cleanup of old executions with configurable retention periods.

---

🚀 Quick Start

# Clone the repository
git clone https://github.com/stherrien/gorax.git
cd gorax

# Start dependencies (PostgreSQL + Redis)
make dev-simple

# Configure environment
cp .env.example .env

# Run migrations
make db-migrate

# Start the API server
make run-api-dev

# In another terminal, start the frontend
cd web && npm install && npm run dev

Open your browser → http://localhost:5173

📖 Full guide: Getting Started

---

🎯 Use Cases

🔧 DevOps Automation Deploy notifications CI/CD pipeline updates Infrastructure monitoring Automated rollbacks	💼 Business Processes Approval workflows Data synchronization Report generation Automated notifications
🎫 IT Operations Incident response Ticket routing Alert management Service health checks	📈 Customer Support Automated responses Ticket escalation SLA monitoring Customer notifications

---

🔌 Integrations

Available Now

Integration	Send	Receive	Actions
Slack	✅	✅	Messages, DMs, Reactions, Updates
GitHub	✅	✅	Issues, PRs, Webhooks
Jira	✅	✅	Issues, Transitions, Comments
PagerDuty	✅	-	Incidents, Alerts
HTTP/REST	✅	✅	Any API endpoint
Webhooks	✅	✅	Inbound & outbound with filtering
JavaScript	✅	-	Custom code execution (Goja sandbox)
Email	✅	-	SMTP & AWS SES support

Enterprise Features

Feature	Description
Human Tasks	Approval workflows with escalation
RBAC	Role-based access control with audit logging
Sub-workflows	Nested workflow execution with recursion protection
Schedules	Cron-based workflow scheduling
Credentials	Encrypted vault with AWS KMS integration

---

📖 Example Workflow

Create a deployment notification in minutes:

{
  "nodes": [
    {
      "type": "trigger:webhook",
      "config": { "path": "/deploy" }
    },
    {
      "type": "slack:send_message",
      "config": {
        "channel": "C1234567890",
        "text": "🚀 Deploying {{trigger.body.version}}"
      }
    }
  ]
}

More examples: examples/

---

🏗️ Architecture

┌─────────────────────────────────────────────────────────────┐
│                      React Frontend                          │
│              Visual Workflow Builder + Dashboard             │
└───────────────────────────┬─────────────────────────────────┘
                            │ REST API
┌───────────────────────────▼─────────────────────────────────┐
│                       Go Backend                             │
│            Chi Router • Executor • Integrations              │
└─────┬────────────────────────────────────────┬───────────────┘
      │                                        │
      ▼                                        ▼
┌─────────────┐                        ┌─────────────┐
│ PostgreSQL  │                        │    Redis    │
│  Workflows  │                        │    Cache    │
│  Executions │                        │   Sessions  │
└─────────────┘                        └─────────────┘

---

🛠️ Development

Prerequisites

• Go 1.23+
• Node.js 18+
• PostgreSQL 14+
• Redis 6+

Commands

make               # Show all available commands
make all           # Install deps and build
make test          # Run all tests
make lint          # Run linters
make build         # Build binaries

Testing

# Backend tests
make test

# Backend tests with coverage
make test-coverage

# Frontend tests
cd web && npm test

Development guide: Local Development

---

📚 Documentation

Resource	Description
Getting Started	Installation and setup
Your First Workflow	Build a workflow in 5 minutes
Monitoring Guide	Prometheus & Grafana setup
Slack Integration	Complete Slack guide
API Reference	REST API documentation
Contributing	Join the community

Full docs: docs/

---

🤝 Contributing

We love contributions! Check out our Contributing Guide.

# 1. Fork the repo
# 2. Create your feature branch
git checkout -b feature/amazing-feature

# 3. Write tests (we follow TDD)
make test

# 4. Commit your changes
git commit -m 'Add amazing feature'

# 5. Push and open a PR
git push origin feature/amazing-feature

---

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

💖 Sponsors

Support this project by becoming a sponsor. Your logo will show up here with a link to your website.

[Become a sponsor]

---

🙏 Acknowledgments

Built with:

• Go - Backend
• React - Frontend
• ReactFlow - Workflow canvas
• Tailwind CSS - Styling
• PostgreSQL - Database
• Redis - Cache

---

📞 Support

• 📖 Documentation
• 💬 Discussions
• 🐛 Issues
• 💌 Email: shawn@gorax.dev

---

Made with ❤️ by Shawn Therrien

⭐ Star us on GitHub — it motivates us a lot!