Skip to content
Experiment tracking for machine and deep learning projects
Branch: master
Clone or download
Latest commit aa86fed Apr 9, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci
client
modelchimp
scripts Update docker files Feb 13, 2019
settings Add static url along with media url Mar 7, 2019
.dockerignore
.env-dev New configuration Mar 7, 2019
.gitignore Add nginx.conf Mar 2, 2019
Dockerfile New configuration Mar 7, 2019
LICENSE
README.md
docker-compose.dev.yml New configuration Mar 7, 2019
docker-compose.local.yml Update docker-compose.local.yml Mar 7, 2019
docker-compose.prod.yml Update production docker settings Mar 7, 2019
docker.sh
ecs-params.yml
manage.py Initial commit Nov 5, 2018
nginx-dev.conf
profile_pic.png Update the logic for dummy profile pic Feb 5, 2019
requirements.txt Update the redis python version Mar 7, 2019
runserver.sh New configuration Mar 7, 2019
runserver_dev.sh

README.md

CircleCI

Join ModelChimp Slack channel

modelchimp-gif

What is ModelChimp?

ModelChimp is an experiment tracker for Deep Learning and Machine Learning experiments.

ModelChimp provides the following features:

  • Real-time tracking of parameters and metrics
  • Realtime charts for experiment metrics at epoch level
  • Code used for the experiment
  • Experiment comparison
  • Collaborate and share experiments with team members
  • Python objects storage such as data objects and model objects which can be used pulled for other experiments
  • Storage of test and validation images for computer vision use cases. Useful for post experiment forensics of deep learning models
  • Server based solution with user registration and authentication

Why ModelChimp?

The idea for ModelChimp came up when I was building a recommendation algorithm for a large retail company based in India. Along with my 6 member team, we would store the meta information related to each experiment in an excel sheet. Two of the biggest problems we encountered while using this approach were:

  1. Sometimes, we would miss out on logging the details while fine-tuning and analysing the model
  2. Sharing these excel sheets over email amongst the team members and the client was a cumbersome process

ModelChimp is a solution to this problem faced by data scientists and machine learning engineers/enthusiasts. They can spend more time on experiments and not on managing the data related to the experiments.

Installation

Choose either Docker based installation or the manual approach.

  • Docker
  • Production Deployment

Docker

  1. Docker is a prerequisite. You can download it from here - https://docs.docker.com/install/
$ git clone https://github.com/ModelChimp/modelchimp
$ cd modelchimp
$ bash docker.sh
  1. After starting ModelChimp server, you can access it at http://localhost:8000

  2. Use the following credentials to log in

username: admin@modelchimp.com
password: modelchimp123
  1. (Optional) If you are using modelchimp on a remote server then add the hostname or ip address in the .env file for the following variables
DOMAIN=<hostname/ip>
ALLOWED_HOSTS=.localhost,127.0.0.1,<hostname/ip>
  1. (Optional) For inviting team members, email credentials have to be added for the following variables in .env file
EMAIL_HOST=
EMAIL_HOST_USER=
EMAIL_HOST_PASSWORD=
EMAIL_PORT=587
DEFAULT_FROM_EMAIL="noreply@modelchimp.com"

Production Deployment

  1. Modelchimp can be deployed referring the docker-compose.local.yml with the container orchestration of your choice. If you are not using any container orchestration and want to start it manually then you can use the following command
docker-compose -f docker-compose.local.yml up --build -d

This will start the containers in daemon mode on the machine where Modelchimp resides. Modelchimp can be accessed from port 8000

  1. (Optional) To store the data in an external postgres database. Add the following credentials to the .env file
DB_HOST=<DB_HOST>
DB_NAME=<DB_NAME>
DB_USER=<DB_USER>
DB_PASSWORD=<DB_PASSWORD>
DBPORT=
  1. (Optional) To store the file assets in an s3 bucket. Add the following credentials to the .env file
AWS_STORAGE_FLAG=True
AWS_ACCESS_KEY_ID=<ID>
AWS_SECRET_ACCESS_KEY=<KEY>
AWS_STORAGE_BUCKET_NAME=<bucket_name>
  1. (Optional) To invite team members to a project. Add the following email credentials to the .env file
EMAIL_HOST=
EMAIL_HOST_USER=
EMAIL_HOST_PASSWORD=
EMAIL_PORT=587
DEFAULT_FROM_EMAIL="noreply@modelchimp.com"

Documentation

You can’t perform that action at this time.