| name | mlflow-experiment-tracker |
| description | MLflow integration skill for experiment tracking, model registry, and artifact management. Enables LLMs to log experiments, compare runs, manage model lifecycle, and retrieve artifacts through the MLflow API. |
| allowed-tools | Read, Grep, Write, Bash, Edit, Glob, WebFetch |
| graph | {"domains":["domain:data-science"],"specializations":["specialization:data-science-ml"],"skillAreas":["skill-area:data-science-experimentation","skill-area:model-registry-management"],"roles":["role:ml-engineer","role:data-scientist"],"workflows":["workflow:ml-model-lifecycle","workflow:experiment-design"]} |
MLflow Experiment Tracker
Integrate with MLflow for comprehensive ML experiment tracking, model registry operations, and artifact management.
Overview
This skill provides capabilities for interacting with MLflow's tracking server and model registry. It enables automated experiment logging, run comparison, model versioning, and artifact retrieval within ML workflows.
Capabilities
Experiment Management
- Create and manage experiments
- Start and end runs programmatically
- Set experiment tags and descriptions
- List and search experiments
Parameter and Metric Logging
- Log hyperparameters for reproducibility
- Track metrics during training (loss, accuracy, etc.)
- Log batch metrics with timestamps
- Set run tags for organization
Artifact Management
- Log model artifacts (serialized models, checkpoints)
- Store datasets and data samples
- Save plots and visualizations
- Retrieve artifacts from completed runs
Model Registry Operations
- Register trained models
- Manage model versions
- Transition models between stages (Staging, Production, Archived)
- Add model descriptions and tags
Run Comparison and Analysis
- Compare metrics across runs
- Search runs by parameters/metrics
- Retrieve best performing runs
- Generate comparison visualizations
Prerequisites
MLflow Installation
pip install mlflow>=2.0.0
MLflow Tracking Server
Configure tracking URI:
import mlflow
mlflow.set_tracking_uri("http://localhost:5000")
Optional: MLflow MCP Server
For enhanced LLM integration, install the MLflow MCP server:
pip install mlflow>=3.4
pip install mlflow-mcp
Usage Patterns
Starting an Experiment Run
import mlflow
mlflow.set_experiment("my-classification-experiment")
with mlflow.start_run(run_name="baseline-model"):
mlflow.log_param("learning_rate", 0.01)
mlflow.log_param("batch_size", 32)
mlflow.log_param("epochs", 100)
for epoch in range(100):
train_loss = train_one_epoch()
mlflow.log_metric("train_loss", train_loss, step=epoch)
mlflow.log_metric("accuracy", 0.95)
mlflow.log_metric("f1_score", 0.93)
mlflow.sklearn.log_model(model, "model")
Searching and Comparing Runs
import mlflow
runs = mlflow.search_runs(
experiment_names=["my-classification-experiment"],
filter_string="metrics.accuracy > 0.9",
order_by=["metrics.accuracy DESC"],
max_results=10
)
best_run = runs.iloc[0]
print(f"Best run ID: {best_run.run_id}")
print(f"Best accuracy: {best_run['metrics.accuracy']}")
Model Registry Operations
import mlflow
model_uri = f"runs:/{run_id}/model"
mlflow.register_model(model_uri, "production-classifier")
client = mlflow.tracking.MlflowClient()
client.transition_model_version_stage(
name="production-classifier",
version=1,
stage="Production"
)
model = mlflow.pyfunc.load_model("models:/production-classifier/Production")
Integration with Babysitter SDK
Task Definition Example
const mlflowTrackingTask = defineTask({
name: 'mlflow-experiment-tracking',
description: 'Track ML experiment with MLflow',
inputs: {
experimentName: { type: 'string', required: true },
runName: { type: 'string', required: true },
parameters: { type: 'object', required: true },
metrics: { type: 'object', required: true },
modelPath: { type: 'string' }
},
outputs: {
runId: { type: 'string' },
experimentId: { type: 'string' },
artifactUri: { type: 'string' }
},
async run(inputs, taskCtx) {
return {
kind: 'skill',
title: `Track experiment: ${inputs.experimentName}/${inputs.runName}`,
skill: {
name: 'mlflow-experiment-tracker',
: {
: ,
: inputs.,
: inputs.,
: inputs.,
: inputs.,
: inputs.
}
},
: {
: ,
:
}
};
}
});
MCP Server Integration
Using mlflow-mcp Server
{
"mcpServers": {
"mlflow": {
"command": "uvx",
"args": ["mlflow-mcp"],
"env": {
"MLFLOW_TRACKING_URI": "http://localhost:5000"
}
}
}
}
Available MCP Tools
mlflow_list_experiments - List all experiments
mlflow_search_runs - Search runs with filters
mlflow_get_run - Get run details
mlflow_log_metric - Log a metric
mlflow_log_param - Log a parameter
mlflow_list_artifacts - List run artifacts
mlflow_get_model_version - Get model version details
Best Practices
- Consistent Naming: Use descriptive experiment and run names
- Complete Logging: Log all hyperparameters, not just tuned ones
- Metric Granularity: Log metrics at appropriate intervals
- Artifact Organization: Use consistent artifact paths
- Model Documentation: Add descriptions to registered models
- Stage Management: Use proper staging workflow (None -> Staging -> Production)
References