# doodad

**Repository Path**: zhackzey/doodad

## Basic Information

- **Project Name**: doodad
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2019-12-23
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# doodad


A library for launching python programs on different machines. Currently supports running locally and over EC2 and SSH (via Docker) with minimal (if any) modification to your existing program.

EC2 code is based on [rllab](https://github.com/rll/rllab/)'s code.


## Setup

- Add this repo to your pythonpath. 
```
export PYTHONPATH=$PYTHONPATH:/path/to/this/repo
```

- Install dependencies
```
pip install -r requirements.txt
```

- (Optional) Set up EC2
```
python scripts/ec2_setup.py
```

- (Optional) Set up [Docker](https://docs.docker.com/engine/installation/). This is required on the target machine if running in a Docker-enabled mode.

- (Optional) Set up GCP
  - https://cloud.google.com/sdk/docs/quickstart-debian-ubuntu
  - https://cloud.google.com/compute/docs/tutorials/python-guide
  - https://cloud.google.com/storage/docs/reference/libraries#client-libraries-install-python


## Example

See [ec2_launch_test.py](https://github.com/justinjfu/doodad/blob/master/examples/ec2_launch/ec2_launch_test.py) for an example on how to run scripts on EC2, over SSH, or locally.

## Tutorial

See the [wiki](https://github.com/justinjfu/doodad/wiki/Home)

## TODOs
- Add support for automatic experiment restarting (will require the user to write a save_state and restore_state function, or use something like CRIU)
- Fix output directories when using docker showing up as root permissions.