Skip to main content

Tune

Doc PyPI versionPyPI pyversions PyPI license codecov

Slack Status

Tune is an abstraction layer for general parameter tuning. It is built on Fugue so it can seamlessly run on any backend supported by Fugue, such as Spark, Dask and local.

Installation

pip install tune

It's recommended to also install Scikit-Learn (for all compatible models tuning) and Hyperopt (to enable Bayesian Optimization)

pip install tune[hyperopt,sklearn]

Quick Start

To quickly start, please go through these tutorials on Kaggle:

  1. Search Space
  2. Non-iterative Problems, such as Scikit-Learn model tuning
  3. Iterative Problems, such as Keras model tuning

Design Philosophy

Tune does not follow Scikit-Learn's model selection APIs and does not provide distributed backend for it. We believe that parameter tuning is a general problem that is not only for machine learning, so our abstractions are built from ground up, the lower level APIs do not assume the objective is a machine learning model, while the higher level APIs are dedicated to solve specific problems, such as Scikit-Learn compatible model tuning and Keras model tuning.

Although we didn't base our solution on any of HyperOpt, Optuna, Ray Tune and Nevergrad etc., we are truly inspired by these wonderful solutions and their design. We also integrated with many of them for deeper level optimizations.

Tuning problems are never easy, here are our goals:

  • Provide the simplest and most intuitive APIs for major tuning cases. We always start from real tuning cases, figure out the minimal requirement for each of them and then determine the layers of abstraction. Read this tutorial, you can see how minimal the interfaces can be.
  • Be scale agnostic and platform agnostic. We want you to worry less about distributed computing, and just focus on the tuning logic itself. Built on Fugue, Tune let you develop your tuning process iteratively. You can test with small spaces on local machine, and then switch to larger spaces and run distributedly with no code change. It can effectively save time and cost and make the process fun and rewarding. And to run any tuning logic distributedly, you only need a core framework itself (Spark, Dask, etc.) and you do not need a database, a queue service or even an embeded cluster.
  • Be highly extendable and flexible on lower level. For example
    • you can extend on Fugue level, for example create an execution engine for Prefect to run the tuning jobs as a Prefect workflow
    • you can integrate third party optimizers and use Tune just as a distributed orchestrator. We have integrated HyperOpt. And Optuna and Nevergrad is on the way.
    • you can start external instances (e.g. EC2 instances) for different training subtasks and to fully utilize your cloud
    • you can combine with distributed training as long as your have enough compute resource

Focuses

Here are our current focuses:

  • A flexible space design and can describe a hybrid space of grid search, random search and second level optimization such as bayesian optimization
  • Integrate with 3rd party tuning frameworks
  • Create generalized and distributed versions of Successive Halving, Hyperband and Asynchronous Successive Halving.

Collaboration

We are looking for collaborators, if you are interested, please let us know. Please join our Slack channel.

Release files for tune 0.1.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for tune 0.1.6
File Size Uploaded
tune-0.1.6.tar.gz 71.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for tune 0.1.6
File Interpreter ABI Platform
tune-0.1.6-py3-none-any.whl Python 3 none any Details

Total release size: 166.8 kB

Release files / tune-0.1.6.tar.gz

Download URL tune-0.1.6.tar.gz
Size 71.0 kB
Tags Source
SHA-256 checksum
How to use checksums
6de79adf3ccfb416989839d0407730b8c2551ee104e6e56a255a032fb70ed955
BLAKE2b-256 checksum
How to use checksums
b038329febab4b0e071e252a8210e12d9415dd47a9793018770970e96d3282d7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.1.1 CPython/3.8.18

Release files / tune-0.1.6-py3-none-any.whl

Download URL tune-0.1.6-py3-none-any.whl
Size 95.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
bc535dcf5261b2d1e68a83ae0548827bfb0219c88b2d4bf4a67d88e8bb4d5286
BLAKE2b-256 checksum
How to use checksums
b6761758304cf0e165b574736b460720a8b32aa91acd3439231200907ca02c00
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.1.1 CPython/3.8.18
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page