PYAE1994's picture
Upload README.md with huggingface_hub
fe0ceaf verified
metadata
title: Workflow Factor OS Simulator
emoji: πŸš€
colorFrom: blue
colorTo: green
sdk: docker
pinned: false
app_port: 7860

Workflow Factor OS Simulator

This is the simulator component of the workflow-factor-os project.

Deployment

This Space is running the simulator service as a Docker container.

API Endpoints

  • /health: Health check endpoint
  • /process/generate: Generate workflow
  • /process/validate: Validate workflow
  • /process/simulate: Simulate workflow

Original Project README

Production-Grade AI Workflow Orchestrator for n8n Built on GitHub + Cloudflare Workers Free Plan Architecture


What Is This?

Workflow Factor OS is a production-grade AI Workflow Engineering Platform that designs, validates, simulates, deploys, and safely activates n8n workflows with professional engineering quality.

This is not a simple JSON generator or prompt-to-workflow toy.

It behaves like:

  • πŸ—οΈ A workflow engineering team
  • πŸ–₯️ A workflow operating system
  • πŸŽ›οΈ An AI orchestration platform

Architecture Overview

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚  USER / FRONTEND                                                     β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                      β”‚ HTTPS
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚  CLOUDFLARE WORKER (apps/worker)                                    β”‚
β”‚  β€’ Thin API Gateway + Orchestrator                                  β”‚
β”‚  β€’ Auth, Rate Limiting, KV State Storage                            β”‚
β”‚  β€’ Routes: /generate /validate /simulate /deploy /approve /activate β”‚
β”‚  β€’ CPU budget: 10ms (Free Plan)                                     β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                      β”‚ Internal API (X-Internal-Secret)
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚  SIMULATOR SERVICE (apps/simulator) β€” External Node.js/Express      β”‚
β”‚  Heavy CPU work offloaded here:                                     β”‚
β”‚  β€’ Intent Interpreter Agent      (GPT-4o)                          β”‚
β”‚  β€’ Workflow Planner Agent        (GPT-4o)                          β”‚
β”‚  β€’ Graph Engine (IR Layer)       (GPT-4o)                          β”‚
β”‚  β€’ Workflow Compiler             (GPT-4o)                          β”‚
β”‚  β€’ Validation Engine             (multi-stage)                     β”‚
β”‚  β€’ Dry Run Simulator             (GPT-4o + chaos testing)          β”‚
β”‚  β€’ Credential Intelligence       (n8n API scan)                    β”‚
β”‚  β€’ Quality Scorer                (multi-dimension scoring)         β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                      β”‚ n8n REST API
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚  n8n INSTANCE                                                        β”‚
β”‚  β€’ Workflow storage (deployed but NOT activated)                    β”‚
β”‚  β€’ Credential management                                            β”‚
β”‚  β€’ Workflow activation (only after human approval)                  β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜