How rohitt-prog/workflowos works
WorkFlowOS turns observed desktop or structured application activity into approved, executable workflows: collect and sanitize events, persist them, discover repeated sequences, interpret and plan them, then execute through integrations or browser automation. Execution outcomes are evaluated and update strategy scores. The graph also preserves the operator UI and application integrations. Some route-to-service wiring and frontend API calls are unsampled; those connections are omitted rather than inferred.
Main entry points: agent/service.py Desktop Agent · automation/service.py Automation Service · discovery/service.py Discovery Service · engine.py Execution Engine
Components 26
User Experience
- WorkFlowOS UI
frontend/src/app/page.tsx - Workflow Views
frontend/src/components/views - Backend API
backend/routes
Activity & Privacy
- Desktop Agent
agent/service.py - Activity Collector
agent/collector.py - Event Normalizer
agent/normalizer.py - Event Client
agent/client.py - Privacy Controls
backend/privacy/service.py - Sensitive Data Redaction
backend/privacy/redaction.py - Event Ingestion
backend/services/event_service.py - MongoDB
backend/database.py
Workflow Discovery
- Discovery Service
discovery/service.py - Session Sequences
discovery/sequence.py - Pattern Detector
discovery/detector.py
Planning & Execution
- AI Workflow Understanding
ai/gemini_service.py - Strategy Planner
automation/planner/planner.py - Automation Service
automation/service.py - Execution Engine
automation/engine.py - Execution Strategies
automation/executor.py - Browser Automation
automation/playwright_executor.py - Integration Registry
integrations/registry.py - App Integrations
integrations
Outcomes & Adaptation
- Outcome Evaluation
backend/learning/outcome.py - Learning Service
backend/learning/service.py - Strategy Scoring
automation/planner/scorer.py
Other components
- Operator
Connections 30
- Operator → Desktop Agent: creates activity
README.md - Desktop Agent → Activity Collector: collects from
agent/service.py - Desktop Agent → Event Normalizer: normalizes events
agent/service.py - Desktop Agent → Event Client: streams events
agent/service.py - Desktop Agent → Privacy Controls: checks collection
agent/service.py - Desktop Agent → Sensitive Data Redaction: sanitizes events
agent/service.py - Event Client → Backend API: posts events
- Backend API → Event Ingestion: ingests events
- Event Ingestion → Sensitive Data Redaction: redacts data
backend/services/event_service.py - Event Ingestion → MongoDB: persists events
backend/services/event_service.py - MongoDB → Discovery Service: supplies activity
README.md - Discovery Service → Session Sequences: builds sequences
discovery/service.py - Discovery Service → Pattern Detector: detects patterns
discovery/service.py - Discovery Service → AI Workflow Understanding: interprets workflows
README.md - AI Workflow Understanding → Strategy Planner: informs plans
README.md - Operator → Automation Service: approves actions
README.md - Backend API → Automation Service: requests automation
- Automation Service → Execution Engine: executes workflow
automation/service.py - Automation Service → Strategy Planner: plans strategies
automation/planner/planner.py - Execution Engine → Execution Strategies: runs actions
automation/engine.py - Execution Engine → Integration Registry: resolves adapters
automation/engine.py - Execution Engine → Browser Automation: uses browser fallback
- Integration Registry → App Integrations: dispatches actions
integrations/registry.py - Automation Service → Learning Service: records outcomes
automation/service.py - Learning Service → Outcome Evaluation: evaluates receipts
backend/learning/service.py - Learning Service → MongoDB: stores learning state
backend/learning/service.py - Strategy Planner → Strategy Scoring: scores strategies
automation/planner/planner.py - Learning Service → Strategy Scoring: updates evidence
- Operator → WorkFlowOS UI: uses interface
- WorkFlowOS UI → Workflow Views: presents workflows