Metadata-Version: 2.1
Name: wanna-ml
Version: 0.2.19
Summary: CLI tool for managing ML projects on Vertex AI
Home-page: https://avast.github.io/wanna-ml
License: MIT
Keywords: mlops,vertex-ai,GCP,google-cloud-platform,machine-learning
Author: Joao Da Silva
Author-email: joao.silva1@avast.com
Requires-Python: >=3.7,<3.11
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Typing :: Typed
Provides-Extra: test
Requires-Dist: Jinja2 (>=3.1.2,<4.0.0)
Requires-Dist: PyYAML (>=5.4.0,<6.0.0)
Requires-Dist: case-converter (>=1.0.2,<2.0.0)
Requires-Dist: checksumdir (>=1.2.0,<2.0.0)
Requires-Dist: cookiecutter (>=2.1.1,<3.0.0)
Requires-Dist: cron-validator (>=1.0.6,<2.0.0)
Requires-Dist: email-validator (>=1.3.0,<2.0.0)
Requires-Dist: emoji (>=1.7.0,<2.0.0)
Requires-Dist: gcloud-config-helper (>=0.3.1,<0.4.0)
Requires-Dist: gitpython (>=3.1.27,<4.0.0)
Requires-Dist: google-api-core (>=2.7.3,<3.0.0)
Requires-Dist: google-cloud-aiplatform (>=1.19.0,<2.0.0)
Requires-Dist: google-cloud-build (>=3.9.3,<4.0.0)
Requires-Dist: google-cloud-compute (>=1.6.1,<2.0.0)
Requires-Dist: google-cloud-functions (>=1.8.3,<2.0.0)
Requires-Dist: google-cloud-logging (>=3.1.2,<4.0.0)
Requires-Dist: google-cloud-monitoring (>=2.11.3,<3.0.0)
Requires-Dist: google-cloud-notebooks (>=1.4.4,<2.0.0)
Requires-Dist: google-cloud-pipeline-components (>=1.0.28,<2.0.0)
Requires-Dist: google-cloud-resource-manager (>=1.6.3,<2.0.0)
Requires-Dist: google-cloud-scheduler (>=2.7.3,<3.0.0)
Requires-Dist: google-cloud-storage (>=2.5.0,<3.0.0)
Requires-Dist: halo (>=0.0.31,<0.0.32)
Requires-Dist: kfp (>=1.8.16,<2.0.0)
Requires-Dist: packaging (>=21.3,<22.0)
Requires-Dist: pathvalidate (>=2.5.2,<3.0.0)
Requires-Dist: pydantic (>=1.10.2,<2.0.0)
Requires-Dist: python-on-whales (>=0.55.0,<0.56.0)
Requires-Dist: pyyaml-include (>=1.3,<2.0)
Requires-Dist: rich (>=12.5.1,<13.0.0)
Requires-Dist: smart-open[gcs] (>=6.2.0,<7.0.0)
Requires-Dist: treelib (>=1.6.1,<2.0.0)
Requires-Dist: typer (==0.7.0)
Requires-Dist: waiting (>=1.4.1,<2.0.0)
Project-URL: Documentation, https://avast.github.io/wanna-ml
Description-Content-Type: text/markdown

# WANNA-ML

---

<p align="center" font-style="italic"> 
<em> Complete MLOps framework for Vertex-AI  </em>
</p>

---

<p align="center">
<a href="https://github.com/avast/wanna-ml/actions/workflows/build.yml" target="_blank">
    <img src="https://github.com/avast/wanna-ml/actions/workflows/build.yml/badge.svg" alt="Build">
</a>
<a href="https://github.com/avast/wanna-ml/actions/workflows/release.yml" target="_blank">
    <img src="https://github.com/avast/wanna-ml/actions/workflows/release.yml/badge.svg" alt="Release">
</a>
<a href="https://codecov.io/gh/avast/wanna-ml" target="_blank">
    <img src="https://codecov.io/gh/avast/wanna-ml/branch/master/graph/badge.svg?token=TAFWK4GJPR" alt="Coverage">
</a>
<a href="https://pypi.org/project/wanna-ml/" target="_blank">
    <img src="https://img.shields.io/pypi/v/wanna-ml?color=%2334D058&label=pypi%20package" alt="Package version">
</a>
</p>

# About WANNA-ML

WANNA-ML is a CLI tool that helps researchers, data scientists, and ML Engineers quickly adapt to Google Cloud Platform (GCP) and get started on the cloud in almost no time.

It makes it easy to start a Jupyter notebook, run training jobs and pipelines, build a Docker container, export logs to Tensorboards, and much more.

We build on top of Vertex-AI managed services and integrate with other GCP services like Cloud Build and Artifact Registry to provide you with a standardized structure for managing ML assets on GCP.


## Help

See the [documentation](https://avast.github.io/wanna-ml/) for more details.


## Get started

### Installation
Install using `pip install -U wanna-ml`.

For more information on the installation process and requirements, visit out [installation page in documentation](https://avast.github.io/wanna-ml/installation)

### Use Docker Image
For your convenience, we have prepared a Docker image with everything you need to get started.
```bash
docker pull michalmrazek9/wanna-ml

docker run -it michalmrazek9/wanna-ml

$ wanna version
```

### Authentication
WANNA-ML relies on `gcloud` for user authentication. 

1. Install the `gcloud` CLI - follow [official guide](https://cloud.google.com/sdk/docs/install)
2. Authenticate with the `gcloud init`
3. Set you Google Application Credentials `gcloud auth application-default login`

### Docker Build
You can use a local Docker daemon to build Docker images, but it is not required. 
You are free to choose between local building on GCP Cloud Build. 
If you prefer local Docker image building, install  [Docker Desktop](https://www.docker.com/products/docker-desktop/).

### GCP IAM Roles and Permissions
Different WANNA-ML calls require different GCP permissions to create given resources on GCP. Our [documentation page](https://avast.github.io/wanna-ml/)
lists recommended GCP IAM roles for each `wanna` command.

## Examples
Jump to [the samples](https://github.com/avast/wanna-ml/tree/master/samples) to see a complete solution 
for various use cases.

## Issues
Please report issues to [GitHub](https://github.com/avast/wanna-ml/issues).

## Contributing
Your contributions are always welcome, see [CONTRIBUTING.md](https://github.com/avast/wanna-ml/blob/master/CONTRIBUTING.md) for more information.
If you like WANNA-ML, don't forget to give our project a star! 

## Licence
Distributed under the MIT License - see [LICENSE](https://github.com/avast/wanna-ml/blob/master/LICENCE).

