From 619e44e54a729bdb7df2cad2516ebd8756db9713 Mon Sep 17 00:00:00 2001
From: krfricke <krfricke@users.noreply.github.com>
Date: Thu, 30 Jul 2020 22:09:03 +0200
Subject: [PATCH] [tune] Added WandbLogger (#9725)

Co-authored-by: Richard Liaw <rliaw@berkeley.edu>
Co-authored-by: Kai Fricke <kai@anyscale.com>
---
 doc/source/images/wandb_logo.png              | Bin 0 -> 16106 bytes
 doc/source/images/wandb_logo_full.png         | Bin 0 -> 66031 bytes
 doc/source/tune/_tutorials/overview.rst       |   6 +
 doc/source/tune/_tutorials/tune-wandb.rst     |  35 ++
 doc/source/tune/examples/wandb_example.rst    |   7 +
 python/ray/.anyscale.yaml                     |   1 +
 python/ray/session-default.yaml               |  77 ++++
 python/ray/tune/.anyscale.yaml                |   1 +
 python/ray/tune/BUILD                         |  17 +
 python/ray/tune/_test.py                      |  43 +++
 python/ray/tune/_test2.py                     | 207 +++++++++++
 python/ray/tune/_test3.py                     |  42 +++
 python/ray/tune/examples/cluster-p3.yaml      |  71 ++++
 python/ray/tune/examples/wandb_example.py     | 103 ++++++
 python/ray/tune/function_runner.py            |  10 +-
 python/ray/tune/integration/wandb.py          | 345 ++++++++++++++++++
 python/ray/tune/progress_reporter.py          |   8 +-
 python/ray/tune/session-default.yaml          |  73 ++++
 python/ray/tune/test.th                       | Bin 0 -> 137 bytes
 .../ray/tune/tests/test_integration_wandb.py  | 298 +++++++++++++++
 python/ray/tune/tests/test_serial.py          |  28 ++
 python/ray/tune/trialv2.py                    |   1 +
 python/ray/tune/utils/util.py                 |   8 +-
 python/requirements_tune.txt                  |   1 +
 24 files changed, 1376 insertions(+), 6 deletions(-)
 create mode 100644 doc/source/images/wandb_logo.png
 create mode 100644 doc/source/images/wandb_logo_full.png
 create mode 100644 doc/source/tune/_tutorials/tune-wandb.rst
 create mode 100644 doc/source/tune/examples/wandb_example.rst
 create mode 100644 python/ray/.anyscale.yaml
 create mode 100644 python/ray/session-default.yaml
 create mode 100644 python/ray/tune/.anyscale.yaml
 create mode 100644 python/ray/tune/_test.py
 create mode 100644 python/ray/tune/_test2.py
 create mode 100644 python/ray/tune/_test3.py
 create mode 100644 python/ray/tune/examples/cluster-p3.yaml
 create mode 100644 python/ray/tune/examples/wandb_example.py
 create mode 100644 python/ray/tune/integration/wandb.py
 create mode 100644 python/ray/tune/session-default.yaml
 create mode 100644 python/ray/tune/test.th
 create mode 100644 python/ray/tune/tests/test_integration_wandb.py
 create mode 100644 python/ray/tune/tests/test_serial.py
 create mode 100644 python/ray/tune/trialv2.py

diff --git a/doc/source/images/wandb_logo.png b/doc/source/images/wandb_logo.png
new file mode 100644
index 0000000000000000000000000000000000000000..fd26b3f37f6fadd7f8ea2c07736c3bffa699d5c4
GIT binary patch
literal 16106
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
Jp<?~w{{zIF9X$X5

literal 0
HcmV?d00001

diff --git a/doc/source/images/wandb_logo_full.png b/doc/source/images/wandb_logo_full.png
new file mode 100644
index 0000000000000000000000000000000000000000..c6beb28ad00991244a2e31222abda7a14fcd974c
GIT binary patch
literal 66031
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

literal 0
HcmV?d00001

diff --git a/doc/source/tune/_tutorials/overview.rst b/doc/source/tune/_tutorials/overview.rst
index 30d72dd55..326e8c403 100644
--- a/doc/source/tune/_tutorials/overview.rst
+++ b/doc/source/tune/_tutorials/overview.rst
@@ -53,6 +53,11 @@ Take a look at any of the below tutorials to get started with Tune.
    :figure: /images/xgboost_logo.png
    :description: :doc:`A guide to tuning XGBoost parameters with Tune <tune-xgboost>`
 
+.. customgalleryitem::
+   :tooltip: Use Weights & Biases within Tune.
+   :figure: /images/wandb_logo.png
+   :description: :doc:`Track your experiment process with the Weights & Biases tools <tune-wandb>`
+
 
 .. raw:: html
 
@@ -69,6 +74,7 @@ Take a look at any of the below tutorials to get started with Tune.
    tune-pytorch-cifar.rst
    tune-pytorch-lightning.rst
    tune-xgboost.rst
+   tune-wandb.rst
 
 Colab Exercises
 ---------------
diff --git a/doc/source/tune/_tutorials/tune-wandb.rst b/doc/source/tune/_tutorials/tune-wandb.rst
new file mode 100644
index 000000000..315aaaaf5
--- /dev/null
+++ b/doc/source/tune/_tutorials/tune-wandb.rst
@@ -0,0 +1,35 @@
+.. _tune-wandb:
+
+Using Weights & Biases with Tune
+================================
+
+`Weights & Biases <https://www.wandb.com/>`_ (Wandb) is a tool for experiment
+tracking, model optimizaton, and dataset versioning. It is very popular
+in the machine learning and data science community for its superb visualization
+tools.
+
+.. image:: /images/wandb_logo_full.png
+  :height: 80px
+  :alt: Weights & Biases
+  :align: center
+  :target: https://www.wandb.com/
+
+Ray Tune currently offers two lightweight integrations for Weights & Biases.
+One is the :ref:`WandbLogger <tune-wandb-logger>`, which automatically logs
+metrics reported to Tune to the Wandb API.
+
+The other one is the :ref:`@wandb_mixin <tune-wandb-mixin>` decorator, which can be
+used with the function API. It automatically
+initializes the Wandb API with Tune's training information. You can just use the
+Wandb API like you would normally do, e.g. using ``wandb.log()`` to log your training
+process.
+
+Please :doc:`see here for a full example </tune/examples/wandb_example>`.
+
+.. _tune-wandb-logger:
+
+.. autoclass:: ray.tune.integration.wandb.WandbLogger
+
+.. _tune-wandb-mixin:
+
+.. autofunction:: ray.tune.integration.wandb.wandb_mixin
diff --git a/doc/source/tune/examples/wandb_example.rst b/doc/source/tune/examples/wandb_example.rst
new file mode 100644
index 000000000..b84970b4e
--- /dev/null
+++ b/doc/source/tune/examples/wandb_example.rst
@@ -0,0 +1,7 @@
+:orphan:
+
+wandb_example
+~~~~~~~~~~~~~~~
+
+
+.. literalinclude:: /../../python/ray/tune/examples/wandb_example.py
\ No newline at end of file
diff --git a/python/ray/.anyscale.yaml b/python/ray/.anyscale.yaml
new file mode 100644
index 000000000..34ad7154c
--- /dev/null
+++ b/python/ray/.anyscale.yaml
@@ -0,0 +1 @@
+project_id: 643
diff --git a/python/ray/session-default.yaml b/python/ray/session-default.yaml
new file mode 100644
index 000000000..fe5aa4c74
--- /dev/null
+++ b/python/ray/session-default.yaml
@@ -0,0 +1,77 @@
+# An unique identifier for the head node and workers of this cluster.
+cluster_name: sgd-pytorch
+
+# The maximum number of workers nodes to launch in addition to the head
+# node. This takes precedence over min_workers. min_workers default to 0.
+min_workers: 2
+initial_workers: 2
+max_workers: 2
+
+target_utilization_fraction: 0.9
+
+# If a node is idle for this many minutes, it will be removed.
+idle_timeout_minutes: 20
+# docker:
+#     image: tensorflow/tensorflow:1.5.0-py3
+#     container_name: ray_docker
+
+# Cloud-provider specific configuration.
+provider:
+    type: aws
+    region: us-west-2
+
+# How Ray will authenticate with newly launched nodes.
+auth:
+    ssh_user: ubuntu
+
+head_node:
+    InstanceType: p3.8xlarge
+    ImageId: latest_dlami
+    InstanceMarketOptions:
+        MarketType: spot
+           # SpotOptions:
+           #     MaxPrice: "9.0"
+
+
+worker_nodes:
+    InstanceType: p3.8xlarge
+    ImageId: latest_dlami
+    # Run workers on spot by default. Comment this out to use on-demand.
+    InstanceMarketOptions:
+        MarketType: spot
+        # SpotOptions:
+        #     MaxPrice: "9.0"
+
+setup_commands:
+    - ray || pip install -U https://s3-us-west-2.amazonaws.com/ray-wheels/latest/ray-0.9.0.dev0-cp36-cp36m-manylinux1_x86_64.whl
+    - pip install -U ipdb ray[rllib] torch torchvision
+    - cp -r ~/tune ~/anaconda3/lib/python3.6/site-packages/ray
+    - cp -r ~/torch_ ~/anaconda3/lib/python3.6/site-packages/ray/util/sgd
+    - cp -r ~/autoscaler ~/anaconda3/lib/python3.6/site-packages/ray/
+    # Install apex.
+    # - rm -rf apex || true
+    # - git clone https://github.com/NVIDIA/apex && cd apex && pip install -v --no-cache-dir  ./ || true
+
+
+file_mounts: {
+    ~/tune: ./tune/,
+    ~/torch_: ./util/sgd/torch/,
+    ~/autoscaler: ./autoscaler/
+}
+
+# Custom commands that will be run on the head node after common setup.
+head_setup_commands: []
+
+# Custom commands that will be run on worker nodes after common setup.
+worker_setup_commands: []
+
+# # Command to start ray on the head node. You don't need to change this.
+head_start_ray_commands:
+    - ray stop
+    - ray start --head --port=6379 --object-manager-port=8076 --autoscaling-config=~/ray_bootstrap_config.yaml --object-store-memory=1000000000
+
+# Command to start ray on worker nodes. You don't need to change this.
+worker_start_ray_commands:
+    - ray stop
+    - ray start --address=$RAY_HEAD_IP:6379 --object-manager-port=8076 --object-store-memory=1000000000
+
diff --git a/python/ray/tune/.anyscale.yaml b/python/ray/tune/.anyscale.yaml
new file mode 100644
index 000000000..7a93e4030
--- /dev/null
+++ b/python/ray/tune/.anyscale.yaml
@@ -0,0 +1 @@
+project_id: 578
diff --git a/python/ray/tune/BUILD b/python/ray/tune/BUILD
index 354da4aec..7bd338764 100644
--- a/python/ray/tune/BUILD
+++ b/python/ray/tune/BUILD
@@ -93,6 +93,14 @@ py_test(
     tags = ["exclusive"],
 )
 
+py_test(
+    name = "test_integration_wandb",
+    size = "small",
+    srcs = ["tests/test_integration_wandb.py"],
+    deps = [":tune_lib"],
+    tags = ["exclusive"],
+)
+
 py_test(
     name = "test_logger",
     size = "small",
@@ -523,6 +531,15 @@ py_test(
     args = ["--smoke-test"]
 )
 
+py_test(
+    name = "wandb_example",
+    size = "small",
+    srcs = ["examples/wandb_example.py"],
+    deps = [":tune_lib"],
+    tags = ["exclusive", "example"],
+    args = ["--mock-api"]
+)
+
 py_test(
     name = "xgboost_example",
     size = "small",
diff --git a/python/ray/tune/_test.py b/python/ray/tune/_test.py
new file mode 100644
index 000000000..34b22f621
--- /dev/null
+++ b/python/ray/tune/_test.py
@@ -0,0 +1,43 @@
+class Trial:
+	hypers: dict = {} # static
+	config: dict = {} # static
+	status: str = None
+	trace: List[Dict] = []
+	checkpoints: List[str] = []
+
+space = {}
+trials = []
+
+trial_checkpoints = {}
+
+while not Optimizer.is_finished():
+	while Optimizer.has_next(space, trials, state):
+		trials += [Optimizer.next(space, trials, state)]
+	trial = Optimizer.choose(trials, state)
+	if Optimizer.should_stop(trial, trials, state):
+		Executor.stop(trial)
+	elif Optimizer.should_pause(trial, state):
+		Executor.pause(trial)
+	elif Optimizer.should_restore(trial, state):
+			restore(trial, trial.checkpoints[-1])
+	elif Optimizer.should_save(trial, state):
+			checkpoint = save(trial)
+	elif Optimizer.should_continue(trial, state):
+			step(trial)
+
+
+exp = Experiment(logdir, name, restore=True)
+failed_trials = exp.get_failed_trials()
+run(failed_trials)
+
+exp = Experiment(logdir, name, restore=True)
+trials = exp.trials_finished()
+trials.reset_status()
+run(trials)
+
+
+optimizer = Optimizer(sweep, metric, *parameters)
+sweep.configure_server()
+sweep.add_logger(Logging)
+sweep.set_executor(executor)
+sweep.run(func, verbose=verbose)
\ No newline at end of file
diff --git a/python/ray/tune/_test2.py b/python/ray/tune/_test2.py
new file mode 100644
index 000000000..a55db1fd1
--- /dev/null
+++ b/python/ray/tune/_test2.py
@@ -0,0 +1,207 @@
+storage = TrialStorage(location)
+trials = storage.get_trials()
+failed_trials = trials.filter(status=Failed)
+parameters = [t.hypers for t in failed_trials]
+
+
+# Builder Pattern
+
+factory = TrialFactory()
+factory.queue(grid)
+run(func, factory)
+
+factory = TrialFactory()
+factory.queue(distribution, num_samples=3, repeat=5)
+run(func, factory)
+
+factory = TrialFactory(optimizer)
+factory.queue(distribution, delay_feedback=3, num_samples=20, max_concurrent=3)
+run(func, factory)
+
+optimizer.restore(storage)
+
+factory = TrialFactory(optimizer)
+factory.queue(parameter_list)
+factory.queue(distribution, num_samples=3)
+
+# single process
+
+trials = []
+
+while factory.has_next():
+    x = factory.next()
+    trial = build(func, x)
+    trials.put(trial)
+    storage.save(factory, trials)
+
+    while not trial.done():
+        result = get_next_result(trial)
+        log(result)
+        storage.update_checkpoint(trial)
+    factory.update(result)
+    storage.save(factory, trials)
+
+
+# concurrent
+
+trials = []
+
+class Actor:
+    def __init__(self):
+        pass
+
+    def configure():
+        pass
+
+    def step():
+        pass
+
+    def save():
+        pass
+
+    def restore():
+        pass
+
+factory, trials = storage.recover()
+optimizer = factory.optimizer
+result_streams = []
+
+while factory.has_next() or not trials.not_done():
+    while factory.has_next():
+        x = factory.next()
+        trial = build(func, x)
+        trials.put(trial)
+        storage.save(factory, trials)
+
+    while Cluster.has_space(trials.live()) and trials.has_pending():
+        trial = trials.pop_pending()
+        handle = Actor.configure(trial)
+        result_streams.add(handle)
+
+    trial, handle, payload = process_next(result_streams)
+
+    if payload.type == "SAVE":
+        trial.update(payload.checkpoint)
+        storage.save(trials)
+    elif payload.type == "STEP":
+        trial.track(payload.result)
+        log(payload.result)
+    else:
+        pass
+
+    if should_checkpoint(trial):
+        Executor.save(handle)
+    elif not is_finished(trial):
+        action = Scheduler(trial, trials)
+        Executor.execute_action(action, trial)
+    elif is_finished(trial):
+        factory.update(trial, result)
+        storage.save(factory, trials)
+
+
+
+# concurrent with checkpointing
+
+
+
+# concurrent with pbt
+
+while factory.has_next() or not trials.not_done():
+    # ...
+
+    trial, handle, payload = process_next(result_streams)
+    elif not is_finished(trial):
+        action = pbt(trial, trials)
+        factory.queue(new_hps, trial3.checkpoint)
+
+        Executor.execute_action(action, trial)
+
+
+
+# Restore last experiment
+exp = Experiment.restore(storage=X)
+trials = exp.get_trial(filter=failed)
+
+run(func, manual_list)
+run(func, space, searcher)
+run(func, grid)
+run(func, manual_list, checkpoints)
+run(func, manual_list)
+
+
+
+
+run(func, exp)
+
+
+# Core concepts:
+# Result: Dict[str, value]
+# t_state: Any
+# Trial: hps[Dict], static_config[Dict]
+# TrialTrace: List[Result], t_state, Trial
+
+# Trainable: t_state, Trial -> t_state, Result
+
+# Optimizer: o_state, List[TrialTrace], Trainable -> (
+# o_state, List[TrialTrace])
+
+# 	SearchAlg: state, Dict[hps, Result] -> state, hps
+
+
+# Execution concepts
+
+# Checkpoint
+# LiveTrial: TrialTrace, location, status, is_idle
+# Status: PENDING, SAVING, RESTORING, TRAINING, SETUP, STOP, ERROR
+# Trainer: Trainable, location, t_state, Trial -> t_state, Result
+step(o_state, LiveTrial, List[LiveTrial]) -> LiveTrial, *args
+	Server(List[LiveTrial]) -> List[LiveTrial]
+	checkpointer(LiveTrial, manager_state) -> TrialTrace
+	Logger(TrialTrace)
+	Optimizer(o_trace, ...)
+	Syncer()
+
+
+
+
+TrialExecutor(reuse_actors, queue_trials)
+ServerConfig(server_port)
+Optimizer(stop, search_alg, scheduler)
+Experiment(resume, local_dir)
+CheckpointManager(
+    sync_on_checkpoint,
+    keep_checkpoints_num,
+    global_checkpoint_period,
+    export_formats,
+    checkpoint_score_attr
+)
+### Tune commands
+tune.set_log_config(
+    upload_dir,
+    sync_to_cloud,
+    trial_name_creator,
+    sync_to_driver,
+    progress_reporter,
+    loggers,
+    verbose
+)
+tune.set_server(ServerConfig)
+tune.run(
+    experiment,
+    trainable_fn,
+    raise_on_failed_trial,   # where can this go?
+    max_failures: int or "fail-fast",
+    trial_executor,
+    restore_from,  # checkpoint path to restore from
+    resources_per_trial,
+    num_samples,
+    search_space, # I'm not a big fan of this because Search Algs have their own search_space too
+    Optimizer,
+    CheckpointManager)
+
+
+
+
+
+
+
diff --git a/python/ray/tune/_test3.py b/python/ray/tune/_test3.py
new file mode 100644
index 000000000..934fc1381
--- /dev/null
+++ b/python/ray/tune/_test3.py
@@ -0,0 +1,42 @@
+checkpoint_manager = State(location)
+checkpoint_manager.optimizer_state
+checkpoint_manager.generator_state
+checkpoint_manager.trial_state
+
+# How much have we learned
+optimizer = Optimizer.from_checkpoint(checkpoint_manager)
+
+optimizer = Optimizer(space, checkpoint=checkpoint_manager)
+for x, y in warm_start:
+	optimizer.report(x, y)
+
+samples = [optimizer.sample(random=True) for i in range(50)]
+
+spec = TrialSpec(func, local_dir, checkpoint)
+
+generator = TrialGenerator.from_checkpoint(checkpoint, optimizer)
+
+generator = TrialGenerator.from_trials(trials)
+
+generator = TrialGenerator.from_spec(spec, optimizer)
+generator.configure(checkpoint_callback)
+generator.queue(samples)
+generator.queue(num_samples=50, repeat=3, max_concurrent=4)
+generator.next()
+
+generator = TrialGenerator.from_multi_spec(spec)
+
+run(generator)
+###################################################
+
+# Exploration process
+trial_list = get_trials(checkpoint_manager)
+failed_trials = [t.reset() for t in trial_list if t.status == "FAILED"]
+
+generator = TrialGenerator.from_trials(failed_trials)
+tune.run(generator)
+
+builder = Builder()
+
+for params in samples:
+	yield builder.build(params)
\ No newline at end of file
diff --git a/python/ray/tune/examples/cluster-p3.yaml b/python/ray/tune/examples/cluster-p3.yaml
new file mode 100644
index 000000000..85a02fde1
--- /dev/null
+++ b/python/ray/tune/examples/cluster-p3.yaml
@@ -0,0 +1,71 @@
+# An unique identifier for the head node and workers of this cluster.
+cluster_name: sgd-pytorch
+
+# The maximum number of workers nodes to launch in addition to the head
+# node. This takes precedence over min_workers. min_workers default to 0.
+min_workers: 0
+initial_workers: 0
+max_workers: 0
+
+target_utilization_fraction: 0.9
+
+# If a node is idle for this many minutes, it will be removed.
+idle_timeout_minutes: 20
+# docker:
+#     image: tensorflow/tensorflow:1.5.0-py3
+#     container_name: ray_docker
+
+# Cloud-provider specific configuration.
+provider:
+    type: aws
+    region: us-west-2
+
+# How Ray will authenticate with newly launched nodes.
+auth:
+    ssh_user: ubuntu
+
+head_node:
+    InstanceType: p3.8xlarge
+    ImageId: latest_dlami
+    InstanceMarketOptions:
+        MarketType: spot
+           # SpotOptions:
+           #     MaxPrice: "9.0"
+
+
+worker_nodes:
+    InstanceType: p3.8xlarge
+    ImageId: latest_dlami
+    # Run workers on spot by default. Comment this out to use on-demand.
+    InstanceMarketOptions:
+        MarketType: spot
+        # SpotOptions:
+        #     MaxPrice: "9.0"
+
+setup_commands:
+    - ray || pip install -U https://s3-us-west-2.amazonaws.com/ray-wheels/latest/ray-0.9.0.dev0-cp36-cp36m-manylinux1_x86_64.whl
+    - pip install -U ipdb ray[rllib] torch torchvision
+    # Install apex.
+    # - rm -rf apex || true
+    # - git clone https://github.com/NVIDIA/apex && cd apex && pip install -v --no-cache-dir  ./ || true
+
+
+file_mounts: {
+}
+
+# Custom commands that will be run on the head node after common setup.
+head_setup_commands: []
+
+# Custom commands that will be run on worker nodes after common setup.
+worker_setup_commands: []
+
+# # Command to start ray on the head node. You don't need to change this.
+head_start_ray_commands:
+    - ray stop
+    - ray start --head --redis-port=6379 --object-manager-port=8076 --autoscaling-config=~/ray_bootstrap_config.yaml --object-store-memory=1000000000
+
+# Command to start ray on worker nodes. You don't need to change this.
+worker_start_ray_commands:
+    - ray stop
+    - ray start --address=$RAY_HEAD_IP:6379 --object-manager-port=8076 --object-store-memory=1000000000
+
diff --git a/python/ray/tune/examples/wandb_example.py b/python/ray/tune/examples/wandb_example.py
new file mode 100644
index 000000000..526a7b1c5
--- /dev/null
+++ b/python/ray/tune/examples/wandb_example.py
@@ -0,0 +1,103 @@
+import argparse
+import tempfile
+from unittest.mock import MagicMock
+
+import numpy as np
+import wandb
+
+from ray import tune
+from ray.tune import Trainable
+from ray.tune.integration.wandb import WandbLogger, WandbTrainableMixin, \
+    wandb_mixin
+from ray.tune.logger import DEFAULT_LOGGERS
+
+
+def train_function(config, checkpoint_dir=None):
+    for i in range(30):
+        loss = config["mean"] + config["sd"] * np.random.randn()
+        tune.report(loss=loss)
+
+
+def tune_function(api_key_file):
+    """Example for using a WandbLogger with the function API"""
+    tune.run(
+        train_function,
+        config={
+            "mean": tune.grid_search([1, 2, 3, 4, 5]),
+            "sd": tune.uniform(0.2, 0.8),
+            "wandb": {
+                "api_key_file": api_key_file,
+                "project": "Wandb_example"
+            }
+        },
+        loggers=DEFAULT_LOGGERS + (WandbLogger, ))
+
+
+@wandb_mixin
+def decorated_train_function(config, checkpoint_dir=None):
+    for i in range(30):
+        loss = config["mean"] + config["sd"] * np.random.randn()
+        tune.report(loss=loss)
+        wandb.log(dict(loss=loss))
+
+
+def tune_decorated(api_key_file):
+    """Example for using the @wandb_mixin decorator with the function API"""
+    tune.run(
+        decorated_train_function,
+        config={
+            "mean": tune.grid_search([1, 2, 3, 4, 5]),
+            "sd": tune.uniform(0.2, 0.8),
+            "wandb": {
+                "api_key_file": api_key_file,
+                "project": "Wandb_example"
+            }
+        })
+
+
+class WandbTrainable(WandbTrainableMixin, Trainable):
+    def step(self):
+        for i in range(30):
+            loss = self.config["mean"] + self.config["sd"] * np.random.randn()
+            wandb.log({"loss": loss})
+        return {"loss": loss, "done": True}
+
+
+def tune_trainable(api_key_file):
+    """Example for using a WandTrainableMixin with the class API"""
+    tune.run(
+        WandbTrainable,
+        config={
+            "mean": tune.grid_search([1, 2, 3, 4, 5]),
+            "sd": tune.uniform(0.2, 0.8),
+            "wandb": {
+                "api_key_file": api_key_file,
+                "project": "Wandb_example"
+            }
+        })
+
+
+if __name__ == "__main__":
+    parser = argparse.ArgumentParser()
+    parser.add_argument(
+        "--mock-api", action="store_true", help="Mock Wandb API access")
+    args, _ = parser.parse_known_args()
+
+    api_key_file = "~/.wandb_api_key"
+
+    if args.mock_api:
+        WandbLogger._logger_process_cls = MagicMock
+        decorated_train_function.__mixins__ = tuple()
+        WandbTrainable._wandb = MagicMock()
+        wandb = MagicMock()  # noqa: F811
+        temp_file = tempfile.NamedTemporaryFile()
+        temp_file.write(b"1234")
+        temp_file.flush()
+        api_key_file = temp_file.name
+
+    tune_function(api_key_file)
+    tune_decorated(api_key_file)
+    tune_trainable(api_key_file)
+
+    if args.mock_api:
+        temp_file.close()
diff --git a/python/ray/tune/function_runner.py b/python/ray/tune/function_runner.py
index 8d81a1132..7408f780d 100644
--- a/python/ray/tune/function_runner.py
+++ b/python/ray/tune/function_runner.py
@@ -369,7 +369,15 @@ def detect_checkpoint_function(train_func, abort=False):
 
 
 def wrap_function(train_func):
-    class ImplicitFunc(FunctionRunner):
+    if hasattr(train_func, "__mixins__"):
+        inherit_from = train_func.__mixins__ + (FunctionRunner, )
+    else:
+        inherit_from = (FunctionRunner, )
+
+    class ImplicitFunc(*inherit_from):
+        _name = train_func.__name__ if hasattr(train_func, "__name__") \
+            else "func"
+
         def _trainable_func(self, config, reporter, checkpoint_dir):
             func_args = inspect.getfullargspec(train_func).args
             if len(func_args) > 1:  # more arguments than just the config
diff --git a/python/ray/tune/integration/wandb.py b/python/ray/tune/integration/wandb.py
new file mode 100644
index 000000000..bfe3786e3
--- /dev/null
+++ b/python/ray/tune/integration/wandb.py
@@ -0,0 +1,345 @@
+import os
+
+from multiprocessing import Process, Queue
+from numbers import Number
+
+from ray import logger
+from ray.tune import Trainable
+from ray.tune.function_runner import FunctionRunner
+from ray.tune.logger import Logger
+
+try:
+    import wandb
+except ImportError:
+    logger.error("pip install 'wandb' to use WandbLogger/WandbTrainableMixin.")
+    wandb = None
+
+WANDB_ENV_VAR = "WANDB_API_KEY"
+_WANDB_QUEUE_END = (None, )
+
+
+def wandb_mixin(func):
+    """wandb_mixin
+
+    Weights and biases (https://www.wandb.com/) is a tool for experiment
+    tracking, model optimization, and dataset versioning. This Ray Tune
+    Trainable mixin helps initializing the Wandb API for use with the
+    ``Trainable`` class or with `@wandb_mixin` for the function API.
+
+    For basic usage, just prepend your training function with the
+    ``@wandb_mixin`` decorator:
+
+    .. code-block:: python
+
+        from ray.tune.integration.wandb import wandb_mixin
+
+        @wandb_mixin
+        def train_fn(config):
+            wandb.log()
+
+
+    Wandb configuration is done by passing a ``wandb`` key to
+    the ``config`` parameter of ``tune.run()`` (see example below).
+
+    The content of the ``wandb`` config entry is passed to ``wandb.init()``
+    as keyword arguments. The exception are the following settings, which
+    are used to configure the ``WandbTrainableMixin`` itself:
+
+    Args:
+        api_key_file (str): Path to file containing the Wandb API KEY.
+        api_key (str): Wandb API Key. Alternative to setting `api_key_file`.
+
+    Wandb's ``group``, ``run_id`` and ``run_name`` are automatically selected
+    by Tune, but can be overwritten by filling out the respective configuration
+    values.
+
+    Please see here for all other valid configuration settings:
+    https://docs.wandb.com/library/init
+
+    Example:
+
+    .. code-block:: python
+
+        from ray import tune
+        from ray.tune.integration.wandb import wandb_mixin
+
+        @wandb_mixin
+        def train_fn(config):
+            for i in range(10):
+                loss = self.config["a"] + self.config["b"]
+                wandb.log({"loss": loss})
+            tune.report(loss=loss, done=True)
+
+        tune.run(
+            train_fn,
+            config={
+                # define search space here
+                "a": tune.choice([1, 2, 3]),
+                "b": tune.choice([4, 5, 6]),
+                # wandb configuration
+                "wandb": {
+                    "project": "Optimization_Project",
+                    "api_key_file": "/path/to/file"
+                }
+            })
+
+    """
+    func.__mixins__ = (WandbTrainableMixin, )
+    func.__wandb_group__ = func.__name__
+    return func
+
+
+def _set_api_key(wandb_config):
+    """Set WandB API key from `wandb_config`. Will pop the
+    `api_key_file` and `api_key` keys from `wandb_config` parameter"""
+    api_key_file = os.path.expanduser(wandb_config.pop("api_key_file", ""))
+    api_key = wandb_config.pop("api_key", None)
+
+    if api_key_file:
+        if api_key:
+            raise ValueError("Both WandB `api_key_file` and `api_key` set.")
+        with open(api_key_file, "rt") as fp:
+            api_key = fp.readline().strip()
+    if api_key:
+        os.environ[WANDB_ENV_VAR] = api_key
+    elif not os.environ.get(WANDB_ENV_VAR):
+        raise ValueError(
+            "No WandB API key found. Either set the {} environment "
+            "variable or pass `api_key` or `api_key_file` in the config".
+            format(WANDB_ENV_VAR))
+
+
+class _WandbLoggingProcess(Process):
+    """
+    We need a `multiprocessing.Process` to allow multiple concurrent
+    wandb logging instances locally.
+    """
+
+    def __init__(self, queue, exclude, to_config, *args, **kwargs):
+        super(_WandbLoggingProcess, self).__init__()
+        self.queue = queue
+        self._exclude = set(exclude)
+        self._to_config = set(to_config)
+        self.args = args
+        self.kwargs = kwargs
+
+    def run(self):
+        wandb.init(*self.args, **self.kwargs)
+        while True:
+            result = self.queue.get()
+            if result == _WANDB_QUEUE_END:
+                break
+            log, config_update = self._handle_result(result)
+            wandb.config.update(config_update, allow_val_change=True)
+            wandb.log(log)
+        wandb.join()
+
+    def _handle_result(self, result):
+        config_update = result.get("config", {}).copy()
+        log = {}
+
+        for k, v in result.items():
+            if k in self._to_config:
+                config_update[k] = v
+            elif k in self._exclude:
+                continue
+            elif not isinstance(v, Number):
+                continue
+            else:
+                log[k] = v
+
+        config_update.pop("callbacks", None)  # Remove callbacks
+        return log, config_update
+
+
+class WandbLogger(Logger):
+    """WandbLogger
+
+    Weights and biases (https://www.wandb.com/) is a tool for experiment
+    tracking, model optimization, and dataset versioning. This Ray Tune
+    ``Logger`` sends metrics to Wandb for automatic tracking and
+    visualization.
+
+    Wandb configuration is done by passing a ``wandb`` key to
+    the ``config`` parameter of ``tune.run()`` (see example below).
+
+    The content of the ``wandb`` config entry is passed to ``wandb.init()``
+    as keyword arguments. The exception are the following settings, which
+    are used to configure the WandbLogger itself:
+
+    Args:
+        api_key_file (str): Path to file containing the Wandb API KEY.
+        api_key (str): Wandb API Key. Alternative to setting ``api_key_file``.
+        excludes (list): List of metrics that should be excluded from
+            the log.
+        log_config (bool): Boolean indicating if the ``config`` parameter of
+            the ``results`` dict should be logged. This makes sense if
+            parameters will change during training, e.g. with
+            PopulationBasedTraining. Defaults to False.
+
+    Wandb's ``group``, ``run_id`` and ``run_name`` are automatically selected
+    by Tune, but can be overwritten by filling out the respective configuration
+    values.
+
+    Please see here for all other valid configuration settings:
+    https://docs.wandb.com/library/init
+
+    Example:
+
+    .. code-block:: python
+
+        from ray.tune.logger import DEFAULT_LOGGERS
+        from ray.tune.integration.wandb import WandbLogger
+        tune.run(
+            train_fn,
+            config={
+                # define search space here
+                "parameter_1": tune.choice([1, 2, 3]),
+                "parameter_2": tune.choice([4, 5, 6]),
+                # wandb configuration
+                "wandb": {
+                    "project": "Optimization_Project",
+                    "api_key_file": "/path/to/file",
+                    "log_config": True
+                }
+            },
+            loggers=DEFAULT_LOGGERS + (WandbLogger, ))
+
+    """
+
+    # Do not log these result keys
+    _exclude_results = ["done", "should_checkpoint"]
+
+    # Use these result keys to update `wandb.config`
+    _config_results = [
+        "trial_id", "experiment_tag", "node_ip", "experiment_id", "hostname",
+        "pid", "date"
+    ]
+
+    _logger_process_cls = _WandbLoggingProcess
+
+    def _init(self):
+        config = self.config.copy()
+
+        try:
+            wandb_config = config.pop("wandb").copy()
+        except KeyError:
+            raise ValueError(
+                "Wandb logger specified but no configuration has been passed. "
+                "Make sure to include a `wandb` key in your `config` dict "
+                "containing at least a `project` specification.")
+
+        _set_api_key(wandb_config)
+
+        exclude_results = self._exclude_results.copy()
+
+        # Additional excludes
+        additional_excludes = wandb_config.pop("excludes", [])
+        exclude_results += additional_excludes
+
+        # Log config keys on each result?
+        log_config = wandb_config.pop("log_config", False)
+        if not log_config:
+            exclude_results += ["config"]
+
+        # Fill trial ID and name
+        trial_id = self.trial.trial_id
+        trial_name = str(self.trial)
+
+        # Project name for Wandb
+        try:
+            wandb_project = wandb_config.pop("project")
+        except KeyError:
+            raise ValueError(
+                "You need to specify a `project` in your wandb `config` dict.")
+
+        # Grouping
+        wandb_group = wandb_config.pop("group", self.trial.trainable_name)
+
+        wandb_init_kwargs = dict(
+            id=trial_id,
+            name=trial_name,
+            resume=True,
+            reinit=True,
+            allow_val_change=True,
+            group=wandb_group,
+            project=wandb_project,
+            config=config)
+        wandb_init_kwargs.update(wandb_config)
+
+        self._queue = Queue()
+        self._wandb = self._logger_process_cls(
+            queue=self._queue,
+            exclude=exclude_results,
+            to_config=self._config_results,
+            **wandb_init_kwargs)
+        self._wandb.start()
+
+    def on_result(self, result):
+        self._queue.put(result)
+
+    def close(self):
+        self._queue.put(_WANDB_QUEUE_END)
+        self._wandb.join(timeout=10)
+
+
+class WandbTrainableMixin:
+    _wandb = wandb
+
+    def __init__(self, config, *args, **kwargs):
+        if not isinstance(self, Trainable):
+            raise ValueError(
+                "The `WandbTrainableMixin` can only be used as a mixin "
+                "for `tune.Trainable` classes. Please make sure your "
+                "class inherits from both. For example: "
+                "`class YourTrainable(WandbTrainableMixin)`.")
+
+        super().__init__(config, *args, **kwargs)
+
+        config = config.copy()
+
+        try:
+            wandb_config = config.pop("wandb").copy()
+        except KeyError:
+            raise ValueError(
+                "Wandb mixin specified but no configuration has been passed. "
+                "Make sure to include a `wandb` key in your `config` dict "
+                "containing at least a `project` specification.")
+
+        _set_api_key(wandb_config)
+
+        # Fill trial ID and name
+        trial_id = self.trial_id
+        trial_name = self.trial_name
+
+        # Project name for Wandb
+        try:
+            wandb_project = wandb_config.pop("project")
+        except KeyError:
+            raise ValueError(
+                "You need to specify a `project` in your wandb `config` dict.")
+
+        # Grouping
+        if isinstance(self, FunctionRunner):
+            default_group = self._name
+        else:
+            default_group = type(self).__name__
+        wandb_group = wandb_config.pop("group", default_group)
+
+        wandb_init_kwargs = dict(
+            id=trial_id,
+            name=trial_name,
+            resume=True,
+            reinit=True,
+            allow_val_change=True,
+            group=wandb_group,
+            project=wandb_project,
+            config=config)
+        wandb_init_kwargs.update(wandb_config)
+
+        self.wandb = self._wandb.init(**wandb_init_kwargs)
+
+    def stop(self):
+        self._wandb.join()
+        if hasattr(super(), "stop"):
+            super().stop()
diff --git a/python/ray/tune/progress_reporter.py b/python/ray/tune/progress_reporter.py
index 621503269..c1325f102 100644
--- a/python/ray/tune/progress_reporter.py
+++ b/python/ray/tune/progress_reporter.py
@@ -469,6 +469,10 @@ def _get_trial_info(trial, parameters, metrics):
     result = trial.last_result
     config = trial.config
     trial_info = [str(trial), trial.status, str(trial.location)]
-    trial_info += [unflattened_lookup(param, config) for param in parameters]
-    trial_info += [unflattened_lookup(metric, result) for metric in metrics]
+    trial_info += [
+        unflattened_lookup(param, config, default=None) for param in parameters
+    ]
+    trial_info += [
+        unflattened_lookup(metric, result, default=None) for metric in metrics
+    ]
     return trial_info
diff --git a/python/ray/tune/session-default.yaml b/python/ray/tune/session-default.yaml
new file mode 100644
index 000000000..da8a1159d
--- /dev/null
+++ b/python/ray/tune/session-default.yaml
@@ -0,0 +1,73 @@
+# An unique identifier for the head node and workers of this cluster.
+cluster_name: sgd-pytorch
+
+# The maximum number of workers nodes to launch in addition to the head
+# node. This takes precedence over min_workers. min_workers default to 0.
+min_workers: 0
+initial_workers: 0
+max_workers: 0
+
+target_utilization_fraction: 0.9
+
+# If a node is idle for this many minutes, it will be removed.
+idle_timeout_minutes: 20
+# docker:
+#     image: tensorflow/tensorflow:1.5.0-py3
+#     container_name: ray_docker
+
+# Cloud-provider specific configuration.
+provider:
+    type: aws
+    region: us-west-2
+
+# How Ray will authenticate with newly launched nodes.
+auth:
+    ssh_user: ubuntu
+
+head_node:
+    InstanceType: g3.8xlarge
+    ImageId: latest_dlami
+    InstanceMarketOptions:
+        MarketType: spot
+           # SpotOptions:
+           #     MaxPrice: "9.0"
+
+
+worker_nodes:
+    InstanceType: g3.8xlarge
+    ImageId: latest_dlami
+    # Run workers on spot by default. Comment this out to use on-demand.
+    InstanceMarketOptions:
+        MarketType: spot
+        # SpotOptions:
+        #     MaxPrice: "9.0"
+
+setup_commands:
+    - ray || pip install -U https://s3-us-west-2.amazonaws.com/ray-wheels/latest/ray-0.9.0.dev0-cp36-cp36m-manylinux1_x86_64.whl
+    - pip install -U ipdb ray[rllib] torch torchvision
+    # Install apex.
+    # - rm -rf apex || true
+    # - git clone https://github.com/NVIDIA/apex && cd apex && pip install -v --no-cache-dir  ./ || true
+
+
+file_mounts: {
+    ~/anaconda3/lib/python3.6/site-packages/ray/tune: ./tune/, 
+    ~/anaconda3/lib/python3.6/site-packages/ray/util/sgd/torch: ./util/sgd/torch/
+}
+
+# Custom commands that will be run on the head node after common setup.
+head_setup_commands: []
+
+# Custom commands that will be run on worker nodes after common setup.
+worker_setup_commands: []
+
+# # Command to start ray on the head node. You don't need to change this.
+head_start_ray_commands:
+    - ray stop
+    - ray start --head --redis-port=6379 --object-manager-port=8076 --autoscaling-config=~/ray_bootstrap_config.yaml --object-store-memory=1000000000
+
+# Command to start ray on worker nodes. You don't need to change this.
+worker_start_ray_commands:
+    - ray stop
+    - ray start --address=$RAY_HEAD_IP:6379 --object-manager-port=8076 --object-store-memory=1000000000
+
diff --git a/python/ray/tune/test.th b/python/ray/tune/test.th
new file mode 100644
index 0000000000000000000000000000000000000000..7dbfb6790dfdf91be66d27abac1aca4d8f581158
GIT binary patch
literal 137
zcmZo*>f*}zGso?xLe`1^NxcRp-<QllvbK;xBSL_IfuW!%za&37KPSE{wWv5VKd+Dx
zs33wDD3g;}Qj(JzpPHAFnV46|)Dgi26fCJMNR2PftV%5|WUeh_(THFL3KnPN7nKyU
fdNV~Z19_QwC53F>ED<aqGxGD&3)#I{N=x+s2jD3%

literal 0
HcmV?d00001

diff --git a/python/ray/tune/tests/test_integration_wandb.py b/python/ray/tune/tests/test_integration_wandb.py
new file mode 100644
index 000000000..aeffaace6
--- /dev/null
+++ b/python/ray/tune/tests/test_integration_wandb.py
@@ -0,0 +1,298 @@
+import os
+import tempfile
+from collections import namedtuple
+from multiprocessing import Queue
+import unittest
+
+from ray.tune import Trainable
+from ray.tune.function_runner import wrap_function
+from ray.tune.integration.wandb import _WandbLoggingProcess, \
+    _WANDB_QUEUE_END, WandbLogger, WANDB_ENV_VAR, WandbTrainableMixin, \
+    wandb_mixin
+from ray.tune.result import TRIAL_INFO
+from ray.tune.trial import TrialInfo
+
+Trial = namedtuple("MockTrial",
+                   ["config", "trial_id", "trial_name", "trainable_name"])
+Trial.__str__ = lambda t: t.trial_name
+
+
+class _MockWandbLoggingProcess(_WandbLoggingProcess):
+    def __init__(self, queue, exclude, to_config, *args, **kwargs):
+        super(_MockWandbLoggingProcess,
+              self).__init__(queue, exclude, to_config, *args, **kwargs)
+
+        self.logs = Queue()
+        self.config_updates = Queue()
+
+    def run(self):
+        while True:
+            result = self.queue.get()
+            if result == _WANDB_QUEUE_END:
+                break
+            log, config_update = self._handle_result(result)
+            self.config_updates.put(config_update)
+            self.logs.put(log)
+
+
+class WandbTestLogger(WandbLogger):
+    _logger_process_cls = _MockWandbLoggingProcess
+
+
+class _MockWandbAPI(object):
+    def init(self, *args, **kwargs):
+        self.args = args
+        self.kwargs = kwargs
+        return self
+
+
+class _MockWandbTrainableMixin(WandbTrainableMixin):
+    _wandb = _MockWandbAPI()
+
+
+class WandbTestTrainable(_MockWandbTrainableMixin, Trainable):
+    pass
+
+
+class WandbIntegrationTest(unittest.TestCase):
+    def setUp(self):
+        pass
+
+    def tearDown(self):
+        pass
+
+    def testWandbLoggerConfig(self):
+        trial_config = {"par1": 4, "par2": 9.12345678}
+        trial = Trial(trial_config, 0, "trial_0", "trainable")
+
+        if WANDB_ENV_VAR in os.environ:
+            del os.environ[WANDB_ENV_VAR]
+
+        # Needs at least a project
+        with self.assertRaises(ValueError):
+            logger = WandbTestLogger(trial_config, "/tmp", trial)
+
+        # No API key
+        trial_config["wandb"] = {"project": "test_project"}
+        with self.assertRaises(ValueError):
+            logger = WandbTestLogger(trial_config, "/tmp", trial)
+
+        # API Key in config
+        trial_config["wandb"] = {"project": "test_project", "api_key": "1234"}
+        logger = WandbTestLogger(trial_config, "/tmp", trial)
+        self.assertEqual(os.environ[WANDB_ENV_VAR], "1234")
+
+        logger.close()
+        del os.environ[WANDB_ENV_VAR]
+
+        # API Key file
+        with tempfile.NamedTemporaryFile("wt") as fp:
+            fp.write("5678")
+            fp.flush()
+
+            trial_config["wandb"] = {
+                "project": "test_project",
+                "api_key_file": fp.name
+            }
+
+            logger = WandbTestLogger(trial_config, "/tmp", trial)
+            self.assertEqual(os.environ[WANDB_ENV_VAR], "5678")
+
+        logger.close()
+        del os.environ[WANDB_ENV_VAR]
+
+        # API Key in env
+        os.environ[WANDB_ENV_VAR] = "9012"
+        trial_config["wandb"] = {"project": "test_project"}
+        logger = WandbTestLogger(trial_config, "/tmp", trial)
+        logger.close()
+
+        # From now on, the API key is in the env variable.
+
+        # Default configuration
+        trial_config["wandb"] = {"project": "test_project"}
+
+        logger = WandbTestLogger(trial_config, "/tmp", trial)
+        self.assertEqual(logger._wandb.kwargs["project"], "test_project")
+        self.assertEqual(logger._wandb.kwargs["id"], trial.trial_id)
+        self.assertEqual(logger._wandb.kwargs["name"], trial.trial_name)
+        self.assertEqual(logger._wandb.kwargs["group"], trial.trainable_name)
+        self.assertIn("config", logger._wandb._exclude)
+
+        logger.close()
+
+        # log config.
+        trial_config["wandb"] = {"project": "test_project", "log_config": True}
+
+        logger = WandbTestLogger(trial_config, "/tmp", trial)
+        self.assertNotIn("config", logger._wandb._exclude)
+        self.assertNotIn("metric", logger._wandb._exclude)
+
+        logger.close()
+
+        # Exclude metric.
+        trial_config["wandb"] = {
+            "project": "test_project",
+            "excludes": ["metric"]
+        }
+
+        logger = WandbTestLogger(trial_config, "/tmp", trial)
+        self.assertIn("config", logger._wandb._exclude)
+        self.assertIn("metric", logger._wandb._exclude)
+
+        logger.close()
+
+    def testWandbLoggerReporting(self):
+        trial_config = {"par1": 4, "par2": 9.12345678}
+        trial = Trial(trial_config, 0, "trial_0", "trainable")
+
+        trial_config["wandb"] = {
+            "project": "test_project",
+            "api_key": "1234",
+            "excludes": ["metric2"]
+        }
+        logger = WandbTestLogger(trial_config, "/tmp", trial)
+
+        r1 = {
+            "metric1": 0.8,
+            "metric2": 1.4,
+            "const": "text",
+            "config": trial_config
+        }
+
+        logger.on_result(r1)
+
+        logged = logger._wandb.logs.get(timeout=10)
+        self.assertIn("metric1", logged)
+        self.assertNotIn("metric2", logged)
+        self.assertNotIn("const", logged)
+        self.assertNotIn("config", logged)
+
+        logger.close()
+
+    def testWandbMixinConfig(self):
+        config = {"par1": 4, "par2": 9.12345678}
+        trial = Trial(config, 0, "trial_0", "trainable")
+        trial_info = TrialInfo(trial)
+
+        config[TRIAL_INFO] = trial_info
+
+        if WANDB_ENV_VAR in os.environ:
+            del os.environ[WANDB_ENV_VAR]
+
+        # Needs at least a project
+        with self.assertRaises(ValueError):
+            trainable = WandbTestTrainable(config)
+
+        # No API key
+        config["wandb"] = {"project": "test_project"}
+        with self.assertRaises(ValueError):
+            trainable = WandbTestTrainable(config)
+
+        # API Key in config
+        config["wandb"] = {"project": "test_project", "api_key": "1234"}
+        trainable = WandbTestTrainable(config)
+        self.assertEqual(os.environ[WANDB_ENV_VAR], "1234")
+
+        del os.environ[WANDB_ENV_VAR]
+
+        # API Key file
+        with tempfile.NamedTemporaryFile("wt") as fp:
+            fp.write("5678")
+            fp.flush()
+
+            config["wandb"] = {
+                "project": "test_project",
+                "api_key_file": fp.name
+            }
+
+            trainable = WandbTestTrainable(config)
+            self.assertEqual(os.environ[WANDB_ENV_VAR], "5678")
+
+        del os.environ[WANDB_ENV_VAR]
+
+        # API Key in env
+        os.environ[WANDB_ENV_VAR] = "9012"
+        config["wandb"] = {"project": "test_project"}
+        trainable = WandbTestTrainable(config)
+
+        # From now on, the API key is in the env variable.
+
+        # Default configuration
+        config["wandb"] = {"project": "test_project"}
+        config[TRIAL_INFO] = trial_info
+
+        trainable = WandbTestTrainable(config)
+        self.assertEqual(trainable.wandb.kwargs["project"], "test_project")
+        self.assertEqual(trainable.wandb.kwargs["id"], trial.trial_id)
+        self.assertEqual(trainable.wandb.kwargs["name"], trial.trial_name)
+        self.assertEqual(trainable.wandb.kwargs["group"], "WandbTestTrainable")
+
+    def testWandbDecoratorConfig(self):
+        config = {"par1": 4, "par2": 9.12345678}
+        trial = Trial(config, 0, "trial_0", "trainable")
+        trial_info = TrialInfo(trial)
+
+        @wandb_mixin
+        def train_fn(config):
+            return 1
+
+        train_fn.__mixins__ = (_MockWandbTrainableMixin, )
+
+        config[TRIAL_INFO] = trial_info
+
+        if WANDB_ENV_VAR in os.environ:
+            del os.environ[WANDB_ENV_VAR]
+
+        # Needs at least a project
+        with self.assertRaises(ValueError):
+            wrapped = wrap_function(train_fn)(config)
+
+        # No API key
+        config["wandb"] = {"project": "test_project"}
+        with self.assertRaises(ValueError):
+            wrapped = wrap_function(train_fn)(config)
+
+        # API Key in config
+        config["wandb"] = {"project": "test_project", "api_key": "1234"}
+        wrapped = wrap_function(train_fn)(config)
+        self.assertEqual(os.environ[WANDB_ENV_VAR], "1234")
+
+        del os.environ[WANDB_ENV_VAR]
+
+        # API Key file
+        with tempfile.NamedTemporaryFile("wt") as fp:
+            fp.write("5678")
+            fp.flush()
+
+            config["wandb"] = {
+                "project": "test_project",
+                "api_key_file": fp.name
+            }
+
+            wrapped = wrap_function(train_fn)(config)
+            self.assertEqual(os.environ[WANDB_ENV_VAR], "5678")
+
+        del os.environ[WANDB_ENV_VAR]
+
+        # API Key in env
+        os.environ[WANDB_ENV_VAR] = "9012"
+        config["wandb"] = {"project": "test_project"}
+        wrapped = wrap_function(train_fn)(config)
+
+        # From now on, the API key is in the env variable.
+
+        # Default configuration
+        config["wandb"] = {"project": "test_project"}
+        config[TRIAL_INFO] = trial_info
+
+        wrapped = wrap_function(train_fn)(config)
+        self.assertEqual(wrapped.wandb.kwargs["project"], "test_project")
+        self.assertEqual(wrapped.wandb.kwargs["id"], trial.trial_id)
+        self.assertEqual(wrapped.wandb.kwargs["name"], trial.trial_name)
+
+
+if __name__ == "__main__":
+    import pytest
+    import sys
+    sys.exit(pytest.main(["-v", __file__]))
diff --git a/python/ray/tune/tests/test_serial.py b/python/ray/tune/tests/test_serial.py
new file mode 100644
index 000000000..d3f2cd452
--- /dev/null
+++ b/python/ray/tune/tests/test_serial.py
@@ -0,0 +1,28 @@
+import pickle
+import ray
+import torch
+import torch.nn.functional as F
+import torch.nn as nn
+
+
+class ConvNet(nn.Module):
+    def __init__(self):
+        super(ConvNet, self).__init__()
+        self.conv1 = nn.Conv2d(1, 3, kernel_size=3)
+        self.fc = nn.Linear(192, 10)
+
+    def forward(self, x):
+        x = F.relu(F.max_pool2d(self.conv1(x), 3))
+        x = x.view(-1, 192)
+        x = self.fc(x)
+        return F.log_softmax(x, dim=1)
+
+def save_me():
+ 	model = ConvNet()
+ 	torch.save(model, "./test.th")
+ 	return 1
+
+ray_func = ray.remote(save_me)
+
+ray.init()
+ray.get(ray_func.remote())
\ No newline at end of file
diff --git a/python/ray/tune/trialv2.py b/python/ray/tune/trialv2.py
new file mode 100644
index 000000000..5c361a366
--- /dev/null
+++ b/python/ray/tune/trialv2.py
@@ -0,0 +1 @@
+trialv2.py
\ No newline at end of file
diff --git a/python/ray/tune/utils/util.py b/python/ray/tune/utils/util.py
index 60fe732b6..94e766b75 100644
--- a/python/ray/tune/utils/util.py
+++ b/python/ray/tune/utils/util.py
@@ -216,7 +216,7 @@ def flatten_dict(dt, delimiter="/"):
     return dt
 
 
-def unflattened_lookup(flat_key, lookup, delimiter="/", default=None):
+def unflattened_lookup(flat_key, lookup, delimiter="/", **kwargs):
     """
     Unflatten `flat_key` and iteratively look up in `lookup`. E.g.
     `flat_key="a/0/b"` will try to return `lookup["a"][0]["b"]`.
@@ -232,8 +232,10 @@ def unflattened_lookup(flat_key, lookup, delimiter="/", default=None):
                 base = base[int(key)]
             else:
                 raise KeyError()
-        except KeyError:
-            return default
+        except KeyError as e:
+            if "default" in kwargs:
+                return kwargs["default"]
+            raise e
     return base
 
 
diff --git a/python/requirements_tune.txt b/python/requirements_tune.txt
index 3e8c2159c..8ddec41d0 100644
--- a/python/requirements_tune.txt
+++ b/python/requirements_tune.txt
@@ -24,5 +24,6 @@ timm
 torch>=1.5.0
 torchvision>=0.6.0
 tune-sklearn==0.0.5
+wandb
 xgboost
 zoopt>=0.4.0