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 ./run.py --mini-batch=50 looks like what you execute normally, now what you have to do looks like this:

orion -n experiment_name ./run.py --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

Installation

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:

Start by starring and forking our Github repo!

Thanks for the support!

Citation

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

@software{xavier_bouthillier_2020_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.11},
  doi          = {10.5281/zenodo.3478592},
  url          = {https://doi.org/10.5281/zenodo.3478592}
}

Roadmap

See ROADMAP.md.

License

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.

Source Distribution

orion-0.1.13.tar.gz (3.3 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

orion-0.1.13-py2.py3-none-any.whl (257.0 kB view details)

Uploaded Python 2Python 3

File details

Details for the file orion-0.1.13.tar.gz.

File metadata

  • Download URL: orion-0.1.13.tar.gz
  • Upload date:
  • Size: 3.3 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/3.9.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.59.0 CPython/3.9.2

File hashes

Hashes for orion-0.1.13.tar.gz
Algorithm Hash digest
SHA256 396e5afd5bf32b785f1578f5341f28df9ea566dcb1572e4274d7b53081adeac1
MD5 dd15ada7c1b354aa8df6c27cf1f3f3bd
BLAKE2b-256 5befd07ddcadc2d7084aa196f32eb1544920ddc6b5f6f459c5c0e8e257342619

See more details on using hashes here.

File details

Details for the file orion-0.1.13-py2.py3-none-any.whl.

File metadata

  • Download URL: orion-0.1.13-py2.py3-none-any.whl
  • Upload date:
  • Size: 257.0 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/3.9.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.59.0 CPython/3.9.2

File hashes

Hashes for orion-0.1.13-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 586c4b7da944b373a037fc14a1ab5eab6c607e2d0c8c62e14ecb41b3075bfdb0
MD5 e2d4c79f32240cc667f7c6bf1ba5ccb9
BLAKE2b-256 29f3f82d601cc5d051d887f7404a5f8cf2835e0bcdb6c116b253646895e0a72a

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page