Need help with orion?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

189 Stars 41 Forks Other 2.7K Commits 38 Opened issues


Asynchronous Distributed Hyperparameter Optimization.

Services available


Need anything else?

Contributors list


|pypi| |py_versions| |license| |doi| |rtfd| |codecov| |github-actions|

.. |pypi| image:: :target: :alt: Current PyPi Version

.. |py_versions| image:: :target: :alt: Supported Python Versions

.. |license| image:: :target: :alt: BSD 3-clause license

.. |doi| image:: :target: :alt: DOI

.. |rtfd| image:: :target: :alt: Documentation Status

.. |codecov| image:: :target: :alt: Codecov Report

.. |github-actions| image:: :target: :alt: Github actions tests

Oríon is an asynchronous framework for black-box function optimization.

Its purpose is to serve as a meta-optimizer for machine learning models and training, as well as a flexible experimentation platform for large scale asynchronous optimization procedures.

Core design value is the minimum disruption of a researcher's workflow. It allows fast and efficient tuning, providing minimum simple non-intrusive (not even necessary!) helper client interface for a user's script.

So if

./ --mini-batch=50
looks like what you execute normally, now what you have to do looks like this:

orion -n experiment_name ./ --mini-batch~'randint(32, 256)'

Check out our

getting started guide
_ or
this presentation
_ for an overview, or our
scikit-learn example
_ for a more hands-on experience. Finally we encourage you to browse our

.. _getting started guide: .. _documentation: .. _scikit-learn example:

Why Oríon?

Effortless to adopt, deeply customizable

  • Adopt it 
    _ with a single line of code
  • Natively asynchronous 
    _, thus resilient and easy to parallelize
  • Offers the latest established hyperparameter
  • Elegant and rich
    search-space definitions 
  • Comprehensive
    _ system with smart defaults
  • Transparent persistence in local or remote
  • Integrate seamlessly 
    _ your own hyper-optimization algorithms
  • Language 
    _ and
    configuration file 
    _ agnostic


Install Oríon by running

$ pip install orion
. For more information consult the

.. _installation guide:

Contribute or Ask

Do you have a question or issues? Do you want to report a bug or suggest a feature? Name it! Please contact us by opening an issue in our repository below and checkout our

contribution guidelines 
  • Issue Tracker:
  • Source Code:

Start by starring and forking our Github repo!

Thanks for the support!


If you use Oríon for published work, please cite our work using the following bibtex entry.

.. code-block:: bibtex

@software{xavierbouthillier2020_4265424, author = {Xavier Bouthillier and Christos Tsirigotis and François Corneau-Tremblay and Thomas Schweizer and Pierre Delaunay and Mirko Bronzi and Lin Dong and Reyhane Askari and Dendi Suhubdy and Hadrien Bertrand and Michael Noukhovitch and Arnaud Bergeron and Dmitriy Serdyuk and Peter Henderson and Pascal Lamblin and Christopher Beckham}, title = {{Epistimio/orion: Plotting API and Database commands}}, month = nov, year = 2020, publisher = {Zenodo}, version = {v0.1.14}, doi = {10.5281/zenodo.3478592}, url = {} }




The project is licensed under the

BSD license 

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.