# 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)
### 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).
Raw data
{
"_id": null,
"home_page": "https://avast.github.io/wanna-ml",
"name": "wanna-ml",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.12.0,>=3.9.0",
"maintainer_email": null,
"keywords": "mlops, vertex-ai, GCP, google-cloud-platform, machine-learning",
"author": "Joao Da Silva",
"author_email": "joao.dasilvacunha@gendigital.com",
"download_url": "https://files.pythonhosted.org/packages/8a/56/e89e3fd51bdc787de4085246d55fa4f5fdec6dc23b80a438412f8415d7f2/wanna_ml-0.3.7.tar.gz",
"platform": null,
"description": "# WANNA-ML\n\n---\n\n<p align=\"center\" font-style=\"italic\"> \n<em> Complete MLOps framework for Vertex-AI </em>\n</p>\n\n---\n\n<p align=\"center\">\n<a href=\"https://github.com/avast/wanna-ml/actions/workflows/build.yml\" target=\"_blank\">\n <img src=\"https://github.com/avast/wanna-ml/actions/workflows/build.yml/badge.svg\" alt=\"Build\">\n</a>\n<a href=\"https://github.com/avast/wanna-ml/actions/workflows/release.yml\" target=\"_blank\">\n <img src=\"https://github.com/avast/wanna-ml/actions/workflows/release.yml/badge.svg\" alt=\"Release\">\n</a>\n<a href=\"https://codecov.io/gh/avast/wanna-ml\" target=\"_blank\">\n <img src=\"https://codecov.io/gh/avast/wanna-ml/branch/master/graph/badge.svg?token=TAFWK4GJPR\" alt=\"Coverage\">\n</a>\n<a href=\"https://pypi.org/project/wanna-ml/\" target=\"_blank\">\n <img src=\"https://img.shields.io/pypi/v/wanna-ml?color=%2334D058&label=pypi%20package\" alt=\"Package version\">\n</a>\n</p>\n\n# About WANNA-ML\n\nWANNA-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.\n\nIt makes it easy to start a Jupyter notebook, run training jobs and pipelines, build a Docker container, export logs to Tensorboards, and much more.\n\nWe 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.\n\n\n## Help\n\nSee the [documentation](https://avast.github.io/wanna-ml/) for more details.\n\n\n## Get started\n\n### Installation\nInstall using `pip install -U wanna-ml`.\n\nFor more information on the installation process and requirements, visit out [installation page in documentation](https://avast.github.io/wanna-ml/installation)\n\n### Authentication\nWANNA-ML relies on `gcloud` for user authentication. \n\n1. Install the `gcloud` CLI - follow [official guide](https://cloud.google.com/sdk/docs/install)\n2. Authenticate with the `gcloud init`\n3. Set you Google Application Credentials `gcloud auth application-default login`\n\n### Docker Build\nYou can use a local Docker daemon to build Docker images, but it is not required. \nYou are free to choose between local building on GCP Cloud Build. \nIf you prefer local Docker image building, install [Docker Desktop](https://www.docker.com/products/docker-desktop/).\n\n### GCP IAM Roles and Permissions\nDifferent WANNA-ML calls require different GCP permissions to create given resources on GCP. Our [documentation page](https://avast.github.io/wanna-ml/)\nlists recommended GCP IAM roles for each `wanna` command.\n\n## Examples\nJump to [the samples](https://github.com/avast/wanna-ml/tree/master/samples) to see a complete solution \nfor various use cases.\n\n## Issues\nPlease report issues to [GitHub](https://github.com/avast/wanna-ml/issues).\n\n## Contributing\nYour contributions are always welcome, see [CONTRIBUTING.md](https://github.com/avast/wanna-ml/blob/master/CONTRIBUTING.md) for more information.\nIf you like WANNA-ML, don't forget to give our project a star! \n\n## Licence\nDistributed under the MIT License - see [LICENSE](https://github.com/avast/wanna-ml/blob/master/LICENCE).\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "CLI tool for managing ML projects on Vertex AI",
"version": "0.3.7",
"project_urls": {
"Documentation": "https://avast.github.io/wanna-ml",
"Homepage": "https://avast.github.io/wanna-ml"
},
"split_keywords": [
"mlops",
" vertex-ai",
" gcp",
" google-cloud-platform",
" machine-learning"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "e7e20b7563500b8db7df98e7b49a8efaeb8c62efbb351d51a508b831294f2d5f",
"md5": "d9531ab2823fb1bba6362eb81dbcbe5f",
"sha256": "46ef3bf0879bf6788bb095c466506315cd216c1cf7897f875a7ff6ad55479b1a"
},
"downloads": -1,
"filename": "wanna_ml-0.3.7-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d9531ab2823fb1bba6362eb81dbcbe5f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.12.0,>=3.9.0",
"size": 100484,
"upload_time": "2024-08-27T11:47:48",
"upload_time_iso_8601": "2024-08-27T11:47:48.935899Z",
"url": "https://files.pythonhosted.org/packages/e7/e2/0b7563500b8db7df98e7b49a8efaeb8c62efbb351d51a508b831294f2d5f/wanna_ml-0.3.7-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "8a56e89e3fd51bdc787de4085246d55fa4f5fdec6dc23b80a438412f8415d7f2",
"md5": "85db1511c710cd4b99a8435946a57b0f",
"sha256": "f577401598f5da1fbbaaa56e239e9796cdaa30286dc2fa03e218fe43d45e7d4f"
},
"downloads": -1,
"filename": "wanna_ml-0.3.7.tar.gz",
"has_sig": false,
"md5_digest": "85db1511c710cd4b99a8435946a57b0f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.12.0,>=3.9.0",
"size": 68538,
"upload_time": "2024-08-27T11:47:50",
"upload_time_iso_8601": "2024-08-27T11:47:50.463546Z",
"url": "https://files.pythonhosted.org/packages/8a/56/e89e3fd51bdc787de4085246d55fa4f5fdec6dc23b80a438412f8415d7f2/wanna_ml-0.3.7.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-27 11:47:50",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "wanna-ml"
}
JSON