Skip to content

Scikit-learn

The sklearn kind stores a scikit-learn model. Kind-specific fields are documented with the creation functions.

Create

Log

log_sklearn

Create and upload a scikit-learn model entity.

Parameters:

Name Type Description Default
project str

Project name.

required
name str

Entity name. If omitted, it is inferred from source.

None
source SourcesOrListOfSources

Local model source path or paths.

required
drop_existing bool

Whether to drop existing entity with the same name.

False
path str

Destination path. If omitted, it is generated.

None
description str

Human-readable entity description.

None
labels list[str]

Entity labels.

None
version str

Entity version.

None
framework str

Model framework.

None
algorithm str

Model algorithm.

None
parameters dict

Model parameters.

None
**kwargs dict

Additional model specification parameters.

{}

Returns:

Type Description
ModelSklearn

Created scikit-learn model entity with uploaded files.

Examples:

Log a scikit-learn model from a local artifact file:

import digitalhub as dh

model = dh.log_sklearn(
    project="my-project",
    name="churn-classifier",
    source="./models/churn-classifier.joblib",
    algorithm="RandomForestClassifier",
)

Register

register_sklearn

Register a scikit-learn model entity for an existing source.

Parameters:

Name Type Description Default
project str

Project name.

required
source SourcesOrListOfSources

Path or URI of the existing model.

required
name str

Entity name. If omitted, it is inferred from source.

None
uuid str

Entity identifier.

None
version str

Entity version.

None
description str

Human-readable entity description.

None
labels list[str]

Entity labels.

None
embedded bool

Whether to embed the entity specification in the project specification.

False
extensions list[dict]

Entity extensions.

None
framework str

Model framework.

None
algorithm str

Model algorithm.

None
parameters dict

Model parameters.

None
**kwargs dict

Additional model specification parameters.

{}

Returns:

Type Description
ModelSklearn

Registered scikit-learn model entity.

Examples:

Register a scikit-learn model that already exists in remote storage:

import digitalhub as dh

model = dh.register_sklearn(
    project="my-project",
    name="registered-churn-classifier",
    source="s3://my-bucket/models/churn-classifier.joblib",
    algorithm="RandomForestClassifier",
)

New

new_model

Create a new model entity in the backend.

Parameters:

Name Type Description Default
project str

Project name.

required
name str

Entity name.

required
kind str

Entity kind.

required
uuid str

Entity identifier.

None
version str

Entity version.

None
description str

Human-readable entity description.

None
labels list[str]

Entity labels.

None
embedded bool

Whether to embed the entity specification in the project specification.

False
path str

Entity path on the local file system or remote storage. It is also the destination path for uploads.

None
extensions list[dict]

Entity extensions.

None
**kwargs dict

Additional entity specification parameters.

{}

Returns:

Type Description
Model

Created model entity.

import digitalhub as dh

model = dh.new_model(
    project="my-project",
    name="churn-classifier",
    kind="sklearn",
    path="s3://my-bucket/models/churn-classifier.joblib",
    algorithm="RandomForestClassifier",
)

Retrieve and manage

Use the shared Model management reference to retrieve, update, or delete a scikit-learn Model.

See the ModelServe runtime and its scikit-learn serving action.