conductor-oss/conductor

Conductor is an event driven agentic workflow engine providing durable and highly resilient execution engine for applications and AI Agents

View on GitHub ↗Jump to charts ↓

Summary Information

Updated 35 minutes ago
Added to GitGenius on August 20th, 2025
Created on December 8th, 2023
Open Issues & Pull Requests: 250 (+0)
Number of forks: 993
Total Stargazers: 32,117 (+2)
Total Subscribers: 48 (+0)

Repository Insights (GitGenius)

Median issue/PR response: 5.8 days
Mean response time: 51.7 days
90th percentile: 179.8 days
Tracked items: 350

How this project is maintained

Around half of the issues opened in the past year never receive a reply. 94% of open issues come from outside the core team, so the backlog reflects real-world use rather than internal planning. Work labelled "agentspan" is answered fastest, typically in about 3 days, while "question" waits about 5 months. Almost all tracked open issues have seen activity in the last three months. Only 8% of issues opened in the past year have been closed.

Charts & Analytics

Fetching additional details & charts...

Issue Activity (beta)

Open issues: 160
New in 7 days: 11
Closed in 7 days: 4
Avg open age: 210 days
Stale 30+ days: 131
Stale 90+ days: 19

Recent activity

Opened in 7 days: 11
Closed in 7 days: 4
Comments in 7 days: 3
Events in 7 days: 3

Top labels

  • bug (148)
  • enhancement (84)
  • question (47)
  • ui (32)
  • agentspan (31)
  • not us (24)
  • documentation (16)
  • backport (10)

Detailed Description

Conductor is an open-source workflow orchestration engine designed for building and managing complex, long-running business processes. Developed originally at Netflix, it’s now a Cloud Native Computing Foundation (CNCF) graduated project, indicating its maturity and community adoption. Unlike simpler task schedulers, Conductor excels at handling workflows that involve human interaction, external system calls, conditional logic, and error handling – essentially, anything beyond a straightforward sequence of tasks. It’s particularly well-suited for microservices architectures where coordinating multiple services is crucial.

At its core, Conductor uses a declarative approach to workflow definition. Workflows are defined as JSON or YAML files, specifying the tasks, their dependencies, and the overall flow of execution. This declarative nature makes workflows versionable, auditable, and easier to understand and maintain. A key concept is the “workflow definition,” which outlines the blueprint for a specific process. These definitions are stored and managed by the Conductor server. Tasks within a workflow can be anything from simple HTTP requests to complex database operations or calls to other microservices. Conductor doesn’t *execute* the tasks themselves; it orchestrates their execution by delegating them to worker nodes.

The architecture of Conductor is comprised of several key components. The *Conductor Server* is the central control plane, responsible for storing workflow definitions, managing workflow instances, and scheduling tasks. *Workers* are responsible for executing the individual tasks assigned to them by the server. Workers can be written in any language and deployed independently, providing flexibility and scalability. A *Metadata API* allows querying the state of workflows and tasks. Furthermore, Conductor provides a robust UI for monitoring workflow executions, debugging issues, and managing workflow definitions. It supports various persistence options, including MySQL, PostgreSQL, and DynamoDB, allowing users to choose the database that best fits their needs.

Conductor distinguishes itself through several features. It supports both stateful and stateless workflows, allowing for complex processes that require maintaining data across multiple tasks. It offers built-in support for human tasks, enabling workflows to pause and wait for human approval or input. Error handling is a first-class citizen, with features like automatic retries, circuit breakers, and error handling policies. Dynamic workflows, where the workflow definition can be modified at runtime, are also supported, providing adaptability to changing business requirements. The event-driven nature of Conductor allows workflows to be triggered by external events, making it suitable for real-time processing.

The repository itself contains the source code for the Conductor server, client libraries (Java, Python, Go), and various tools for development and deployment. It includes extensive documentation, examples, and a community forum for support. The project actively encourages contributions and has a well-defined contribution process. The repository also contains Docker images for easy deployment and testing. Overall, Conductor provides a powerful and flexible platform for orchestrating complex workflows, making it a valuable tool for organizations building and managing microservices-based applications and automating business processes.