GoliteFlow

Key Features

Quick Start (5 Minutes)

Step 1: Download Binary

Choose your platform:

# Linux/macOS
curl -L https://github.com/sintakaridina/goliteflow/releases/latest/download/goliteflow-linux-amd64 -o goliteflow
chmod +x goliteflow

# Windows (PowerShell)
curl -L https://github.com/sintakaridina/goliteflow/releases/latest/download/goliteflow-windows-amd64.exe -o goliteflow.exe

# macOS (Apple Silicon)
curl -L https://github.com/sintakaridina/goliteflow/releases/latest/download/goliteflow-darwin-arm64 -o goliteflow
chmod +x goliteflow

Step 2: Create Your First Workflow

Create my-workflow.yml:

version: "1.0"
workflows:
  - name: hello_world_demo
    schedule: "@manual" # Run manually for testing
    tasks:
      - id: greet
        command: "echo Hello from GoliteFlow!"

      - id: check_system
        command: "python --version && node --version"
        depends_on: ["greet"]

      - id: list_files
        command: "ls -la" # or "dir" on Windows
        depends_on: ["check_system"]

Step 3: Run & Monitor

# Run the workflow
./goliteflow run --config=my-workflow.yml

# Generate enhanced HTML report
./goliteflow report-enhanced --output=dashboard.html

# Start continuous daemon (production)
./goliteflow daemon --config=my-workflow.yml

Real-World Examples

Python Data Pipeline:

version: "1.0"
workflows:
  - name: daily_etl
    schedule: "0 2 * * *" # Every day at 2 AM
    tasks:
      - id: extract_data
        command: "python scripts/extract_from_api.py"
        retry_count: 3
      - id: process_data
        command: "python scripts/transform_data.py"
        depends_on: ["extract_data"]
      - id: send_report
        command: "python scripts/email_summary.py"
        depends_on: ["process_data"]

Node.js API Monitoring:

version: "1.0"
workflows:
  - name: api_health_check
    schedule: "*/5 * * * *" # Every 5 minutes
    tasks:
      - id: health_check
        command: "node monitoring/health-check.js"
      - id: alert_on_failure
        command: "node monitoring/send-alert.js"
        condition: "on_failure"

Why Choose GoliteFlow?

Comparison with Other Solutions

Enhanced HTML Reports

GoliteFlow generates production-ready HTML dashboards with enterprise features:

Dashboard Features

• Real-time Statistics - Success rates, execution trends, performance metrics
• Interactive Timeline - Visual workflow execution history
• Task Details - Individual results, retry attempts, error logs
• Dependency Graph - Visual task dependency mapping
• Responsive Design - Works on desktop and mobile

Enterprise Management

• Automatic Rotation - Limits main report to recent executions
• Monthly Archival - Historical data organized by month
• Auto Cleanup - Configurable retention policies
• Fast Loading - Constant performance regardless of history size
• Analytics Dashboard - Comprehensive workflow analytics

Report Commands

# Generate enhanced report (recommended)
./goliteflow report-enhanced --output=dashboard.html

# Configure report management
./goliteflow report-enhanced --max-executions=100 --archive-after=30

# Manage archives
./goliteflow report-manage stats      # View statistics
./goliteflow report-manage cleanup    # Clean old archives

View Live Demo Report →

Production Deployment

# Install as system service
sudo systemctl enable goliteflow
sudo systemctl start goliteflow
    

# Install as Windows service
.\goliteflow.exe daemon --install --config=production.yml
net start goliteflow
    

# Run in container
docker run -v $(pwd):/workflows \
  sintakaridina/goliteflow:latest \
  daemon --config=/workflows/config.yml
    

Monitoring & Scaling

• Real-time Dashboard - Live HTML reports with auto-refresh
• Report Rotation - Automatic archival prevents size growth
• Archive Management - Monthly organization with configurable cleanup
• Health Monitoring - Built-in status checks and alerting
• Performance - Handles thousands of executions efficiently

Community

📖 Documentation