Skip to main content

The opinionated deep learning template.

Project description

Deep Learning Project Template

Downloads GitHub release PyPI License: MIT Documentation Status Code style: black Open in Colab

The opinionated deep learning template.

Description

dlproject believes three things.

  1. All code should be documented.
  2. All experiments should be logged.
  3. Configs are better than constants.

Installation

These instructions assume you are using a linux machine with at least one GPU (CUDA 11.1).

  1. Create a new repository using this template and change to the root directory. For example,

    git clone git@github.com:benjamindkilleen/dlproject.git
    cd dlproject
    
  2. Install dependencies using either Anaconda (preferred) or Pip:

    • Anaconda: modify environment.yml to suit your needs. Then run:

      conda env create -f environment.yml
      conda activate dlproject
      

      This will create a new environment with the project installed as an edit-able package.

    • Pip: Install Pytorch to ensure GPU available. Then:

      pip install -r requirements.txt
      pip install -e .
      

Usage

The project is separated into "experiments," which are just different main functions. Use the experiment group parameter to change which experiment is running. For example:

python main.py experiment=mnist

The results are then neatly sorted into the newly-created results directory (ignored by default). This is important for reproduceability, utilizing Hydra's automatic logging and config storage.

Documentation

Documentation and tutorials for dlproject are available here. You should document your code as you go. If you use Visual Studio Code, this is an extension which will create Google style docstrings automatically.

To build the docstrings you write into a local static web-page, run

pip install -r docs/requirements.txt
sphinx-apidoc -f -o docs/source dlproject
cd docs
make html

And open /docs/build/html/index.html in your browser.

Citation

@article{YourName,
  title={Your Title},
  author={Your team},
  journal={Location},
  year={Year}
}

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

dlproject-0.1.1.tar.gz (6.5 kB view hashes)

Uploaded Source

Built Distribution

dlproject-0.1.1-py3-none-any.whl (8.0 kB view hashes)

Uploaded Python 3

Supported by

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