| --- |
| 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](https://github.com/pyaesonegtckglay-dotcom/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) │ |
| └─────────────────────────────────────────────────────────────────────┘ |
| ``` |
|
|
