stratosphere 0.1.42

A lightweight experimentation toolkit for data scientists.

Stratosphere

A lightweight experimentation toolkit for data scientists.

Designed to be accessibile, fast and robust. stratosphere lets you:

1. Define programmatically your experiments
2. Execute them in parallel with different backends
3. Track their real-time metrics and final results
4. Store them as serialized objects and tabular data in your database(s)
5. Query them with the best-suited interface: SQL, Pandas and Python

How is it possible?

• Fast and light: Try it now with JupyterLite, it runs entirely in the browser
• Built on top of solid components: SQLAlchemy, SQLite, Pandas, Joblib and Dask
• Designed for data accessibility: Use it where you need it. For example, you can experiment in-memory, persist locally, replicate tables on render.com, and publish results on preset.io (all free tiers!)

Installation

It officially requires Python >= 3.8.0, but it can be forced to work smoothly also on Python 3.7.13-15 (supporting Colab, Binder). On Python >= 3.8.0:

• With PyPI: pip install "stratosphere[complete]" --upgrade # Install everything
• With Poetry: poetry add stratosphere@latest --extras complete # Install everything

On Python 3.7.13-15 with Google Colab or Binder, execute the following at the beginning of the notebook:

# Install dependencies
!pip install pandas joblib sqlalchemy sqlalchemy-utils ulid-py cloudpickle colorama tqdm --upgrade

# Install [complete] extras, required to run the tutorial
!pip install tabulate scikit-learn dask[complete] --upgrade

# Install the latest stratosphere version, ignoring the python version and dependencies
!pip install stratosphere --upgrade --ignore-requires-python --no-dependencies

You can also install only the stratosphere library (dropping the [complete] extras). Modules like stratosphere.utils.dask, stratosphere.utils.metrics, and stratosphere.utils.widgets won't work until you also install dask[complete], scikit-learn, and ipywidgets, respectively. These extras are required to run some of the tutorial notebooks.

Documentation

• In the intro notebook, you'll be exposed to the key concepts. It runs entirely in the browser.
• In the tutorial notebooks, you'll cover the advanced topics. Working locally, on Colab and on Binder.

Project pages

• PyPI
• Github

License

This project is licensed under the terms of the BSD 3-Clause License.

Development

See the development page.

Contributing

Work in progress!