squirrel-core 0.12.1.dev829423

Squirrel is a Python library that enables ML teams to share, load, and transform data in a collaborative, flexible, and efficient way.

Squirrel Core

Share, load, and transform data in a collaborative, flexible, and efficient way

---

What is Squirrel?

Squirrel is a Python library that enables ML teams to share, load, and transform data in a collaborative, flexible, and efficient way.

1. SPEED: Avoid data stall, i.e. the expensive GPU will not be idle while waiting for the data.

2. COSTS: First, avoid GPU stalling, and second allow to shard & cluster your data and store & load it in bundles, decreasing the cost for your data bucket cloud storage.

3. FLEXIBILITY: Work with a flexible standard data scheme which is adaptable to any setting, including multimodal data.

4. COLLABORATION: Make it easier to share data & code between teams and projects in a self-service model.

Stream data from anywhere to your machine learning model as easy as:

it = (Catalog.from_plugins()["imagenet"].get_driver()
      .get_iter("train")
      .map(lambda r: (augment(r["image"]), r["label"]))
      .batched(100))

Check out our full getting started tutorial notebook. If you have any questions or would like to contribute, join our Slack community.

Installation

Currently, we have not released a functional version of squirrel-core and squirrel-datasets-core into the public pypi registry. Therefore we ask you to use the following installation method, which uses the source code directly:

First, you need to clone the squirrel-core and squirrel-datasets-core repositories by:

git clone https://github.com/merantix-momentum/squirrel-core.git

and

git clone https://github.com/merantix-momentum/squirrel-datasets-core.git

Then you can install both packages by

pip install -e "squirrel-core[all]"

and

pip install -e "squirrel-datasets-core[all]"

In the documentation, you may also see some requirements to install the two packages first, please follow the instruction above, instead of installing from public pypi registry (e.g pip install squirrel-core or pip install squirrel-datasets-core). We kindly ask for your patience.

Documentation

To view the docs locally, please use the following command in root directory of the repo:

sphinx-build ./docs ./docs/build

The command above will create all documentation pages under ./docs/build. To view the start page, open ./docs/build/index.html in your browser.

Example Notebooks

Check out the Squirrel-datasets repository for open source and community-contributed tutorial and example notebooks of using Squirrel.

Contributing

Squirrel is open source and community contributions are welcome!

Check out the contribution guide to learn how to get involved.

The humans behind Squirrel

We are Merantix Momentum, a team of ~30 machine learning engineers, developing machine learning solutions for industry and research. Each project comes with its own challenges, data types and learnings, but one issue we always faced was scalable data loading, transforming and sharing. We were looking for a solution that would allow us to load the data in a fast and cost-efficient way, while keeping the flexibility to work with any possible dataset and integrate with any API. That's why we build Squirrel – and we hope you'll find it as useful as we do! By the way, we are hiring!

Citation

If you use Squirrel in your research, please cite it using:

@article{2022squirrelcore,
  title={Squirrel: A Python library that enables ML teams to share, load, and transform data in a collaborative, flexible, and efficient way.},
  author={Squirrel Developer Team},
  journal={GitHub. Note: https://github.com/merantix-momentum/squirrel-core},
  year={2022}
}