UfaFlow

Overview

UfaFlow is a lightweight asynchronous worker manager and load balancer for Python services. It distributes traffic across worker processes with predictable lifecycle control, simple configuration, and async-first execution.

The project is designed for teams that need:

• a simple worker runtime
• process-level isolation
• async-first execution
• predictable startup and shutdown behavior
• easy deployment in development and production-like environments

Why UfaFlow

Many applications need more than a single process, but do not require the complexity of a full orchestration platform. UfaFlow acts as a lightweight execution layer that helps you:

• manage multiple workers with a single runtime
• balance traffic or task distribution across processes
• keep lifecycle management explicit and controllable
• reduce operational overhead for small-to-medium service deployments

Key Features

• Async-first worker orchestration
• Configurable worker pool and process management
• Lightweight request balancing across workers
• Support for FastAPI and Python service integration
• YAML-based configuration
• Clean startup and shutdown lifecycle behavior
• Simple deployment model for local and cloud environments

Installation

pip install ufaflow

Quick start

Create a YAML config file:

health_interval: 5
health_timeout: 2
frontends:
  - listen_host: "0.0.0.0"
    listen_port: 8080
    algorithm: round_robin
    backends:
      - host: "127.0.0.1"
        port: 8001
      - host: "127.0.0.1"
        port: 8002

Run the load balancer:

python -m ufaflow.cli config.yaml

To run with multiple worker processes:

python -m ufaflow.cli config.yaml --workers 4

License

MIT