mosaicml-cli

library0.8.3pypypiunverified

The `mosaicml-cli` provides a command-line interface for interacting with Databricks Mosaic AI training. It allows users to authenticate, manage runs, models, and clusters directly from their terminal. The current version is 0.8.3, and new versions are released periodically to align with updates to the Mosaic AI platform.

ai-ml llm-agents devops

pip install mosaicml-cli

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · MOSAICML-CLI

mosaicml-cli

ai-mlpythonv0.8.3

Install

7.3s avg

Import

—

Disk

62MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.7.5 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.910 runs

installs and imports cleanly · install 0.0s · import 0.000s · 62.3MB

glibc

py 3.10–3.910 runs

installs and imports cleanly · install 7.3s · import 0.000s · 64MB

62MB installed

● package 62MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

app

✓ from mcli.cli import app

✗ from mcli.cli import app

The most crucial step is to log in using `mosaicml login`. This authenticates your CLI session with the Mosaic AI platform. After successful login, you can execute various commands, such as listing models or initiating training runs.

mosaicml login # Follow the on-screen instructions to authenticate via a browser. # List available models (requires authentication) mosaicml list models # Example of running a training job (requires a config.yaml file and an authenticated session) # This command assumes you have a 'config.yaml' file in your current directory. # For a real quickstart, replace 'path/to/my_config.yaml' with your actual path. # If you don't have one, just run 'mosaicml list models' as a basic check. # mosaicml run path/to/my_config.yaml

mcli --version

Debug

Known issues

gotchaCommon confusion between `mosaicml-cli` and `mosaicml` library. `mosaicml-cli` is solely for command-line interaction. For programmatic Python usage (e.g., in a script or application), you should install and import the `mosaicml` library.

fix

If you intend to write Python code, install `pip install mosaicml`. If you need the command-line tool, use `pip install mosaicml-cli`.

affects: All versions

gotchaAll commands interacting with the Mosaic AI platform require prior authentication. Failure to authenticate will result in 'Not logged in' errors.

fix

Run `mosaicml login` to authenticate your session, or ensure `MOSAICML_API_KEY` and `MOSAICML_API_URL` environment variables are set.

affects: All versions

breakingAs a relatively new CLI, command names, arguments, and configuration schemas may evolve in minor or patch releases, especially as the underlying Mosaic AI platform updates.

fix

Always refer to the official documentation or the `mosaicml <command> --help` output for the most up-to-date syntax. Keep your CLI updated with `pip install --upgrade mosaicml-cli`.

affects: 0.x.x versions

gotcha`mosaicml-cli` requires Python 3.11 or higher. Using an older Python version will lead to installation failures or runtime errors.

fix

Ensure your Python environment is at least 3.11. Consider using `pyenv` or `conda` to manage multiple Python versions.

affects: <=0.8.3

Upgrade

Version history

0.8.3latest on PyPI · released Oct 16, 2025

Audit

Dependencies

mosaicmlrequiredProvides the underlying Python SDK functionality that the CLI interacts with.

typerrequiredCLI framework used to build the command-line interface.

richrequiredUsed for rich text and beautiful output in the terminal.

Agent activity

28 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/mosaicml/mosaicml-cli ↗

packagehttps://pypi.org/project/mosaicml-cli/ ↗

homepagehttps://www.databricks.com/product/mosaic-ai ↗