Skip to main content
Join the official 2020 Python Developers SurveyStart the survey!

Platform to version model, data, parameters alongside git versioned source code

Project description




Gitter PyPi lgtm

A version control system for software 2.0.


Complete Documentation: stockroom.page


Introduction

Stockroom is a platform to version models, data, parameters, experiment artifacts etc. alongside git versioned source code.

  • It is easy. The APIs are very similar to dictionaries in python
  • It works alongside Git - in case you need to version source code as well. It's OK if you don't.
  • High performance, thanks to the amazing hangar library
  • Integration with PyTorch and it's ecosystem, so that you don't need to write the complex pipeline code.

Why

One important motivation behind the initial design of stockroom is to avoid users learning another tool for versioning. We try to make the APIs as minimal and familiar as possible. Similar to other versioning tools, stockroom let "git" does checkout and rely on "git" to move between branches/commits. But unlike other tools, we channel your data access through the smart API so that we don't need to move the huge data files around when you traverse between commits.

Installation

$ pip install stockroom

Example

from stockroom import StockRoom

stock = StockRoom(write=True)
model.load_state_dict(stock.model['resnet50'])
for e in range(epochs):
    for i in range(limit):
        optimizer.zero_grad()
        x, y = stock.data['dataset_name', i]
        out = model(x)
        loss = criterion(out, y)
        loss.backward()
        optimizer.step()
        if loss < previous_loss:
            stock.experiment['loss'] = loss.item()
            stock.model['resnet50'] = model.state_dict()
            stock.commit('adding a better model')

Contributing

We'd love to have you in the contributors list. Do check out the contributors guide before submitting a PR. Here is our latest #Hall-Of-Fame

License

This project is licensed under the terms of the Apache Software License 2.0

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for stockroom, version 0.2.2
Filename, size File type Python version Upload date Hashes
Filename, size stockroom-0.2.2-py3-none-any.whl (17.1 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size stockroom-0.2.2.tar.gz (119.1 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page