Skip to main content

๐—ข๐˜„๐—ป ๐—ฌ๐—ผ๐˜‚๐—ฟ ๐——๐—ฎ๐˜๐—ฎ ๐—ฆ๐—ฐ๐—ถ๐—ฒ๐—ป๐—ฐ๐—ฒ. Skore's open-source Python library accelerates ML model development with automated evaluation reports, smart methodological guidance, and comprehensive cross-validation analysis.

Project description

license python downloads pypi Discord

skore logo

Own Your Data Science

Elevate ML Development with Built-in Recommended Practices
Documentation โ€” Community โ€” YouTube โ€” Skore Hub


๐Ÿงฉ What is Skore?

The core mission of Skore is to turn uneven ML development into structured, effective decision-making. It is made of two complementary components:

  • Skore Lib: the open-source Python library (described here!) designed to help data scientists boost their ML development with effective guidance and tooling.
  • Skore Hub: the collaborative layer where teams connect, learn more on our product page.

โญ Support us with a star and spread the word - it means a lot! โญ

Key features of Skore Lib

Evaluate and inspect: automated insightful reports.

  • EstimatorReport: feed your scikit-learn compatible estimator and dataset, and it generates recommended metrics, feature importance, and plots to help you evaluate and inspect your model. All in just one line of code. Under the hood, we use efficient caching to make the computations blazing fast.
  • CrossValidationReport: get a skore estimator report for each fold of your cross-validation.
  • ComparisonReport: benchmark your skore estimator reports.

Diagnose: catch methodological errors before they impact your models.

  • train_test_split supercharged with methodological guidance: the API is the same as scikit-learn's, but skore displays warnings when applicable. For example, it warns you against shuffling time series data or when you have class imbalance.

๐Ÿ—“๏ธ What's next?

Skore Lib is just at the beginning of its journey, but weโ€™re shipping fast! Frequent updates and new features are on the way as we work toward our vision of becoming a comprehensive library for data scientists.

โšก๏ธ Quick start

Installation

With pip

We recommend using a virtual environment (venv). You need python>=3.10.

Then, you can install skore by using pip:

# If you just use skore locally
pip install -U skore
# If you wish to also interact with the skore hub
pip install -U skore[hub]

With conda

skore is available in conda-forge both for local and hub use:

conda install conda-forge::skore

You can find information on the latest version here.

Get assistance when developing your ML/DS projects

Evaluate your model using skore.CrossValidationReport:

from sklearn.datasets import make_classification
from sklearn.linear_model import LogisticRegression

from skore import CrossValidationReport

X, y = make_classification(n_classes=2, n_samples=100_000, n_informative=4)
clf = LogisticRegression()

cv_report = CrossValidationReport(clf, X, y)

# Display the help tree to see all the insights that are available to you
cv_report.help()
# Display the report metrics that was computed for you:
metrics_summary = cv_report.metrics.summarize()
metrics_summary
# Display the ROC curve that was generated for you:
roc_plot = cv_report.metrics.roc()
roc_plot.plot()

Create or connect to a Project to save and load reports

from sklearn.datasets import make_classification
from sklearn.linear_model import LogisticRegression
from sklearn.model_selection import train_test_split

import skore

# Create or connect to a Project
project = skore.Project("<name>") # local
project = skore.Project("hub://<tenant>/<name>") # hub

X, y = make_classification(n_classes=2, n_samples=100_000, n_informative=4)
X_train, X_test, y_train, y_test = train_test_split(X, y)
clf = LogisticRegression()

report = skore.EstimatorReport(
    clf,
    X_train=X_train,
    y_train=y_train,
    X_test=X_test,
    y_test=y_test,
)

# Save report to Project for future reference
project.put("my_report", report)

Learn more in our documentation.

๐Ÿ› ๏ธ Contributing

Join our mission to promote open-source and make machine learning development more robust and effective. If you'd like to contribute, please check the contributing guidelinesย here.

๐Ÿ‘‹ Feedback & Community

  • Join our Discord to share ideas or get support.
  • Request a feature or report a bug via GitHub Issues.

Support

Skore is tested on Linux and Windows, for at most 4 versions of Python, and at most 4 versions of scikit-learn:

  • Python 3.10
    • scikit-learn 1.4
    • scikit-learn 1.7
  • Python 3.11
    • scikit-learn 1.4
    • scikit-learn 1.7
  • Python 3.12
    • scikit-learn 1.4
    • scikit-learn 1.7
  • Python 3.13
    • scikit-learn 1.5
    • scikit-learn 1.6
    • scikit-learn 1.7

Brought to you by

Probabl logo

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

skore-0.10.0.tar.gz (119.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

skore-0.10.0-py3-none-any.whl (149.9 kB view details)

Uploaded Python 3

File details

Details for the file skore-0.10.0.tar.gz.

File metadata

  • Download URL: skore-0.10.0.tar.gz
  • Upload date:
  • Size: 119.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for skore-0.10.0.tar.gz
Algorithm Hash digest
SHA256 6d0473cf5259eefab6cad63bab037cf8c4912d4080575e355ea4485c254bda53
MD5 20c4045731b1c96858b0fa16badd381d
BLAKE2b-256 b865c8f65d3965f314bd4db8be410e9035388dc387fcd9236a11716a177b1d05

See more details on using hashes here.

Provenance

The following attestation bundles were made for skore-0.10.0.tar.gz:

Publisher: release.yml on probabl-ai/skore

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file skore-0.10.0-py3-none-any.whl.

File metadata

  • Download URL: skore-0.10.0-py3-none-any.whl
  • Upload date:
  • Size: 149.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for skore-0.10.0-py3-none-any.whl
Algorithm Hash digest
SHA256 84fe07dbae56820e81097ef864cfcdda6453b19f48e8457ede512f0a11cfbf2f
MD5 09333c1558dbd48f512f517d62275fb4
BLAKE2b-256 07305ad676c82424cf5d09fd71f905055f3513045c7b336c3b45e64055c168ed

See more details on using hashes here.

Provenance

The following attestation bundles were made for skore-0.10.0-py3-none-any.whl:

Publisher: release.yml on probabl-ai/skore

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

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