---
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)                  │
└─────────────────────────────────────────────────────────────────────┘
```