Skip to main content

Architecture Overview

BoCoFlow is built with a modular, microservices-inspired architecture that separates concerns and enables independent development of components.

System Architecture​

┌─────────────────────────────────────────────┐
│           Electron Desktop App              │
│  ┌─────────────────────────────────────┐   │
│  │         React Web UI                 │   │
│  │    (bocoflow-web)                   │   │
│  └─────────────────────────────────────┘   │
│                    │                        │
│  ┌─────────────────────────────────────┐   │
│  │     Electron Main Process            │   │
│  │    (bocoflow-electron)              │   │
│  └─────────────────────────────────────┘   │
└─────────────────────────────────────────────┘
                     │
                     │ HTTP/REST
                     │
    ┌────────────────────────────────┐
    │      FastAPI Server             │
    │    (bocoflow-server)           │
    └────────────────────────────────┘
                     │
    ┌────────────────────────────────┐
    │      Workflow Engine            │
    │     (bocoflow-core)            │
    └────────────────────────────────┘
                     │
    ┌────────────────────────────────┐
    │   Python Environments (UV)      │
    │   - Node execution              │
    │   - Dependency isolation        │
    └────────────────────────────────┘

Development Scripts​

Universal development script handles:

  • Environment setup
  • Dependency installation
  • Service orchestration
  • Hot reloading
  • Log aggregation

Contributing​

See our Contributing Guide for details on:

  • Development setup
  • Code style guidelines
  • Testing requirements
  • Pull request process