test workflow
build workflow
Coverage Status

Optimus is an easy-to-use, reliable, and performant workflow orchestrator for data transformation, data modeling, pipelines, and data quality management. It enables data analysts and engineers to transform their data by writing simple SQL queries and YAML configuration while Optimus handles dependency management, scheduling and all other aspects of running transformation jobs at scale.

Key Features

Discover why users choose Optimus as their main data transformation tool.

  • Warehouse management: Optimus allows you to create and manage your data warehouse tables and views through YAML based configuration.
  • Scheduling: Optimus provides an easy way to schedule your SQL transformation through a YAML based configuration.
  • Automatic dependency resolution: Optimus parses your data transformation queries and builds a dependency graphs automaticaly instead of users defining their source and taget dependencies in DAGs.
  • Dry runs: Before SQL query is scheduled for transformation, during deployment query will be dry-run to make sure it passes basic sanity checks.
  • Powerful templating: Optimus provides query compile time templating with variables, loop, if statements, macros, etc for allowing users to write complex tranformation logic.
  • Cross tenant dependency: Optimus is a multi-tenant service, if there are two tenants registered, serviceA and serviceB then service B can write queries referencing serviceA as source and Optimus will handle this dependency as well.
  • Hooks: Optimus provides hooks for post tranformation logic. e,g. You can sink BigQuery tables to Kafka.
  • Extensibility: Optimus support Python transformation and allows for writing custom plugins.
  • Workflows: Optimus provides industry proven workflows using git based specification management and REST/GRPC based specification management for data warehouse management.


Optimus has two components, Optimus service that is the core orchestrator installed on server side, and a CLI binary used to interact with this service. You can install Optimus CLI using homebrew on macOS:

$ brew install odpf/taps/optimus
$ optimus --help

Optimus is an easy-to-use, reliable, and performant workflow orchestrator for
data transformation, data modeling, pipelines, and data quality management.

  optimus [command]

Available Commands:
  backup      Backup a resource and its downstream
  completion  generate the autocompletion script for the specified shell
  config      Manage optimus configuration required to deploy specifications
  deploy      Deploy current optimus project to server
  extension   Operate with extension
  help        Help about any command
  job         Interact with schedulable Job
  replay      Re-running jobs in order to update data for older dates/partitions
  resource    Interact with data resource
  serve       Starts optimus service
  version     Print the client version information

  -h, --help       help for optimus
      --no-color   Disable colored output

Additional help topics:
  optimus validate check if specifications are valid for deployment

Use "optimus [command] --help" for more information about a command.


Explore the following resources to get started with Optimus:

  • Guides provides guidance on using Optimus.
  • Concepts describes all important Optimus concepts.
  • Reference contains details about configurations, metrics and other aspects of Optimus.
  • Contribute contains resources for anyone who wants to contribute to Optimus.

Running locally

Optimus requires the following dependencies:

  • Golang (version 1.16 or above)
  • Git

Run the following commands to compile optimus from source

$ git clone [email protected]:odpf/optimus.git
$ cd optimus
$ make

Use the following command to run

$ ./optimus version

Optimus service can be started with

$ ./optimus serve

serve command has few required configurations that needs to be set for it to start. Configuration can either be stored
in .optimus.yaml file or set as environment variable. Read more about it in getting started.


Optimus is currently undergoing heavy development with frequent, breaking API changes. Current major version is zero (v0.x.x) to accommodate rapid development and fast iteration while getting early feedback from users (feedback on APIs are appreciated). The public API could change without a major version update before v1.0.0 release.


Development of Optimus happens in the open on GitHub, and we are grateful to the community for contributing bugfixes and improvements. Read below to learn how you can take part in improving Optimus.

Read our contributing guide to learn about our development process, how to propose bugfixes and improvements, and how to build and test your changes to Optimus.

To help you get your feet wet and get you familiar with our contribution process, we have a list of good first issues that contain bugs which have a relatively limited scope. This is a great place to get started.


Optimus is Apache 2.0 licensed.


View Github