Flux Model Zoo

This repository contains various demonstrations of the Flux machine learning library. Any of these may freely be used as a starting point for your own models.

The models are broadly categorised into the folders vision (e.g. large convolutional neural networks (CNNs)), text (e.g. various recurrent neural networks (RNNs) and natural language processing (NLP) models), games (Reinforcement Learning / RL). See the READMEs of respective models for more information.

Usage

Each folder is its own Julia project, which lists the packages you need to run the models. You can run the models by opening Julia in the project folder and running

using Pkg; Pkg.activate("."); Pkg.instantiate()

to install all needed packages. Then you can run the model code with include("script.jl") or by running the script line-by-line. More details are available in the README for each model.

Models with a cuda folder can be loaded with NVIDIA GPU support, if you have a CUDA installed.

using Pkg; Pkg.activate("cuda"); Pkg.instantiate()
using CuArrays

Contributing

We welcome contributions of new models. They should be in a folder with a project and manifest file, to pin all relevant packages, as well as a README to explain what the model is about, how to run it, and what results it achieves (if applicable). If possible models should not depend directly on GPU functionality, but ideally should be CPU/GPU agnostic.

Model Listing

• Vision
  • MNIST
    • Simple multi-layer perceptron
    • Simple ConvNets
    • Simple Auto-Encoder
    • Variational Auto-Encoder
  • VGG 16/19 on CIFAR10
  • CPPN (Blog)
• Text
  • CharRNN
  • Character-level language detection
  • Seq2Seq phoneme detection on CMUDict
  • Recursive net on IMDB sentiment treebank
• Other
  • Differential Equations
  • BitString Parity Challenge
  • MLP on housing data (low level API)
  • FizzBuzz
  • Meta-Learning
  • Logistic Regression Iris