Metadata-Version: 2.4
Name: mlflow-plugin-manager
Version: 0.1.1
Summary: PyPI package management integrated directly into MLflow's web interface
Home-page: https://github.com/thijsdezoete/mlflow-plugin-manager
Author: Thijs de Zoete
Author-email: 
Project-URL: Bug Tracker, https://github.com/thijsdezoete/mlflow-plugin-manager/issues
Project-URL: Documentation, https://thijsdezoete.github.io/mlflow-plugin-manager/
Project-URL: Source, https://github.com/thijsdezoete/mlflow-plugin-manager
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: flask>=2.0.0
Requires-Dist: requests>=2.25.0
Requires-Dist: packaging>=20.0
Requires-Dist: asgiref>=3.4.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: black>=22.0.0; extra == "dev"
Requires-Dist: flake8>=4.0.0; extra == "dev"
Provides-Extra: server
Requires-Dist: flask-sqlalchemy>=2.5.0; extra == "server"
Requires-Dist: flask-migrate>=3.0.0; extra == "server"
Requires-Dist: flask-login>=0.5.0; extra == "server"
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license-file
Dynamic: project-url
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# MLflow Plugin Manager

![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)
![PyPI](https://img.shields.io/pypi/v/mlflow-plugin-manager)
![Python](https://img.shields.io/pypi/pyversions/mlflow-plugin-manager)

**PyPI package management integrated directly into MLflow's web interface**

## 🚀 Quick Start

### Install from PyPI (Recommended)
```bash
pip install mlflow-plugin-manager
```

### Install from Source
```bash
git clone https://github.com/thijsdezoete/mlflow-plugin-manager.git
cd mlflow-plugin-manager
pip install -e .
```

## 📦 Core Features

- **📦 Direct PyPI Integration** - Install any MLflow-compatible package from PyPI through the web interface
- **🔄 Version Management** - Compare installed versions against latest PyPI releases, update or rollback as needed
- **🎯 Version Pinning** - Install specific package versions for reproducibility
- **🔍 Package Discovery** - Browse and search MLflow packages indexed from PyPI
- **📝 Installation Logs** - View complete pip output for debugging
- **🔧 REST API** - Programmatic access for CI/CD integration

## 🎮 Usage

Run the MLflow server with the Plugin Manager:

```bash
mlflow server --app-name plugin_manager
```

Access the Plugin Manager at:
- MLflow UI: http://localhost:5000
- Plugin Manager: http://localhost:5000/plugin-manager/
- Click "Plugins" in the sidebar for quick access

## ⚙️ Configuration

### Environment Variables

- `PLUGIN_SERVER_URL`: URL of the plugin metadata server
  - **Default**: `https://api.mlflowplugins.com` (production)
  - **Local Development**: Set to `http://localhost:5001` if running your own server

```bash
# Use production server (default)
mlflow server --app-name plugin_manager

# Use local server for development
export PLUGIN_SERVER_URL="http://localhost:5001"
mlflow server --app-name plugin_manager
```

## 🏗️ Architecture

The MLflow Plugin Manager consists of two components:

1. **MLflow Plugin** (this package): Integrates with MLflow's web interface and handles package installation locally via pip
2. **Metadata Server**: Provides plugin information (hosted at api.mlflowplugins.com)

> **Note**: Package installation happens locally on your machine. The remote server only provides plugin metadata (available packages, versions, etc.).

## 🔌 API Endpoints

- `GET /plugin-manager/` - Web interface
- `GET /plugin-manager/installed-plugins` - List installed packages
- `GET /plugin-manager/available-plugins` - Browse PyPI packages
- `POST /plugin-manager/install-plugin` - Install a package
- `POST /plugin-manager/uninstall-plugin` - Remove a package
- `GET /plugin-manager/check-plugin-updates` - Check for updates
- `POST /plugin-manager/upgrade-plugin` - Update a package

## 📋 Requirements

- Python 3.8+
- MLflow 2.0+ (optimized for 3.0+)
- pip package manager

## 🔧 Advanced: Running Your Own Metadata Server

For maintainers who want to run their own plugin metadata server:

```bash
cd server
python reindex_plugins.py  # Index packages from PyPI
python app.py              # Run metadata server on port 5001
```

> **Note**: End users don't need to run these commands - the default configuration uses api.mlflowplugins.com.

## 🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

## 📝 License

This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.

## 🔗 Links

- [GitHub Repository](https://github.com/thijsdezoete/mlflow-plugin-manager)
- [PyPI Package](https://pypi.org/project/mlflow-plugin-manager/)
- [Issue Tracker](https://github.com/thijsdezoete/mlflow-plugin-manager/issues)
- [MLflow Documentation](https://mlflow.org)


