Skip to content
Projects

tensorwerk/hangar-py has 204 GitHub stars and 29 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-16 20:34 UTC. Last push 2020-09-14.

How these counts are measured

Measured star growth

in 24h
0
in 7 days
Update delayed
in 15 days
Update delayed
in 1 month
Update delayed

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

Hangar is version control for tensor data. Commit, branch, merge, revert, and collaborate in the data-defined software era.

Developer Tools

README.md

Original

======== Overview

.. start-badges

.. list-table:: :stub-columns: 1

* - docs
  - |docs|
* - tests
  - | |gh-build-status| |codecov|
    | |lgtm|
* - package
  - | |version| |wheel| |conda-forge|
    | |supported-versions| |supported-implementations|
    | |license|

.. |docs| image:: https://readthedocs.org/projects/hangar-py/badge/?style=flat :target: https://readthedocs.org/projects/hangar-py :alt: Documentation Status

.. |gh-build-status| image:: https://github.com/tensorwerk/hangar-py/workflows/Run%20Test%20Suite/badge.svg?branch=master :alt: Build Status :target: https://github.com/tensorwerk/hangar-py/actions?query=workflow%3A%22Run+Test+Suite%22+branch%3Amaster+event%3Apush+is%3Acompleted

.. |codecov| image:: https://codecov.io/gh/tensorwerk/hangar-py/branch/master/graph/badge.svg :alt: Code Coverage :target: https://codecov.io/gh/tensorwerk/hangar-py

.. |lgtm| image:: https://img.shields.io/lgtm/grade/python/g/tensorwerk/hangar-py.svg?logo=lgtm&logoWidth=18 :alt: Language grade: Python :target: https://lgtm.com/projects/g/tensorwerk/hangar-py/context:python

.. |version| image:: https://img.shields.io/pypi/v/hangar.svg :alt: PyPI Package latest release :target: https://pypi.org/project/hangar

.. |license| image:: https://img.shields.io/github/license/tensorwerk/hangar-py :alt: GitHub license :target: https://github.com/tensorwerk/hangar-py/blob/master/LICENSE

.. |conda-forge| image:: https://img.shields.io/conda/vn/conda-forge/hangar.svg :alt: Conda-Forge Latest Version :target: https://anaconda.org/conda-forge/hangar

.. |wheel| image:: https://img.shields.io/pypi/wheel/hangar.svg :alt: PyPI Wheel :target: https://pypi.org/project/hangar

.. |supported-versions| image:: https://img.shields.io/pypi/pyversions/hangar.svg :alt: Supported versions :target: https://pypi.org/project/hangar

.. |supported-implementations| image:: https://img.shields.io/pypi/implementation/hangar.svg :alt: Supported implementations :target: https://pypi.org/project/hangar

.. end-badges

Hangar is version control for tensor data. Commit, branch, merge, revert, and collaborate in the data-defined software era.

  • Free software: Apache 2.0 license

What is Hangar?

Hangar is based off the belief that too much time is spent collecting, managing, and creating home-brewed version control systems for data. At its core Hangar is designed to solve many of the same problems faced by traditional code version control system (i.e. Git), just adapted for numerical data:

  • Time travel through the historical evolution of a dataset
  • Zero-cost Branching to enable exploratory analysis and collaboration
  • Cheap Merging to build datasets over time (with multiple collaborators)
  • Completely abstracted organization and management of data files on disk
  • Ability to only retrieve a small portion of the data (as needed) while still maintaining complete historical record
  • Ability to push and pull changes directly to collaborators or a central server (i.e. a truly distributed version control system)

The ability of version control systems to perform these tasks for codebases is largely taken for granted by almost every developer today; however, we are in-fact standing on the shoulders of giants, with decades of engineering which has resulted in these phenomenally useful tools. Now that a new era of "Data-Defined software" is taking hold, we find there is a strong need for analogous version control systems which are designed to handle numerical data at large scale... Welcome to Hangar!

The Hangar Workflow:

::

   Checkout Branch
          |
          ▼
 Create/Access Data
          |
          ▼
Add/Remove/Update Samples
          |
          ▼
       Commit

Log Style Output:

.. code-block:: text

  • 5254ec (master) : merge commit combining training updates and new validation samples |
    | * 650361 (add-validation-data) : Add validation labels and image data in isolated branch
  • | 5f15b4 : Add some metadata for later reference and add new training samples received after initial import |/
  • baddba : Initial commit adding training images and labels

Learn more about what Hangar is all about at https://hangar-py.readthedocs.io/

Installation

Hangar is in early alpha development release!

::

pip install hangar

Documentation

https://hangar-py.readthedocs.io/

Development

To run the all tests run::

tox

Note, to combine the coverage data from all the tox environments run:

.. list-table:: :widths: 10 90 :stub-columns: 1

- - Windows
  - ::

        set PYTEST_ADDOPTS=--cov-append
        tox

- - Other
  - ::

        PYTEST_ADDOPTS=--cov-append tox