Skip to main content

Asynchronous [black-box] Optimization

Project description

Current PyPi Version Supported Python Versions BSD 3-clause license DOI Documentation Status Codecov Report 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 documentation.

Why Oríon?

Effortless to adopt, deeply customizable


Install Oríon by running $ pip install orion. For more information consult the installation guide.


  • 2021-07-14 - SciPy 2021
  • 2021-05-19 - Dask Summit 2021
  • 2021-03-16 - AICamp (Video) (Slides)
  • 2019-11-28 - Tech-talk @ Mila (Video) (Slides)

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:

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.

  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
  month        = nov,
  year         = 2020,
  publisher    = {Zenodo},
  version      = {v0.1.14},
  doi          = {10.5281/zenodo.3478592},
  url          = {}




The project is licensed under the BSD license.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for orion, version 0.1.15
Filename, size File type Python version Upload date Hashes
Filename, size orion-0.1.15-py2.py3-none-any.whl (271.3 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size orion-0.1.15.tar.gz (21.3 MB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page