Skip to main content

A lightweight experimentation toolkit for data scientists.

Project description

Stratosphere

A lightweight experimentation toolkit for data scientists.

PyPI - Python Version PyPI - License PyPI - Version PyPI - Wheel PyPI - Installs Black - Code style Open in Colab Open in Binder

Designed for simplicity, efficiency and robustness. 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

Built on top of solid components: SQLAlchemy, SQLite, Pandas, Joblib and Dask.

Stratosphere

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

Follow the tutorial notebooks to learn the basic concepts. You can run the notebooks locally, on Colab and on Binder.

Project pages

License

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

Development

See the development page.

Contributing

Work in progress!

Project details


Download files

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

Source Distribution

stratosphere-0.1.33.tar.gz (21.2 kB view hashes)

Uploaded Source

Built Distribution

stratosphere-0.1.33-py3-none-any.whl (25.3 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page