[![License: Apache 2](https://img.shields.io/badge/License-apache2-blue.svg?style=flat&longCache=true)](LICENSE)
[![Polyaxon API](https://img.shields.io/docker/pulls/polyaxon/polyaxon-api)](https://hub.docker.com/r/polyaxon/polyaxon-api)
[![Slack](https://img.shields.io/badge/Slack-1.5k%20members-blue.svg?style=flat&logo=slack&longCache=true)](https://polyaxon.com/slack/)
[![Docs](https://img.shields.io/badge/docs-stable-brightgreen.svg?style=flat&longCache=true)](https://polyaxon.com/docs/)
[![Release](https://img.shields.io/badge/release-v2.5.2-brightgreen.svg?longCache=true)](https://polyaxon.com/docs/releases/2-5/)
[![GitHub](https://img.shields.io/badge/issue_tracker-github-blue?style=flat&logo=github&longCache=true)](https://github.com/polyaxon/polyaxon/issues)
[![GitHub](https://img.shields.io/badge/roadmap-github-blue?style=flat&logo=github&longCache=true)](https://github.com/orgs/polyaxon/projects/5)
[![CLI](https://github.com/polyaxon/cli/actions/workflows/cli.yml/badge.svg)](https://github.com/polyaxon/cli/actions/workflows/cli.yml)
[![Polyaxon](https://github.com/polyaxon/polyaxon/actions/workflows/cli.yml/badge.svg)](https://github.com/polyaxon/polyaxon/actions/workflows/cli.yml)
[![Haupt](https://github.com/polyaxon/polyaxon/actions/workflows/haupt.yml/badge.svg)](https://github.com/polyaxon/polyaxon/actions/workflows/haupt.yml)
[![Hypertune](https://github.com/polyaxon/polyaxon/actions/workflows/hypertune.yml/badge.svg)](https://github.com/polyaxon/polyaxon/actions/workflows/hypertune.yml)
[![Traceml](https://github.com/polyaxon/polyaxon/actions/workflows/traceml.yml/badge.svg)](https://github.com/polyaxon/polyaxon/actions/workflows/traceml.yml)
[![Codacy Badge](https://api.codacy.com/project/badge/Grade/90c05b6b112548c1a88b950beceacb69)](https://www.codacy.com/app/polyaxon/polyaxon?utm_source=github.com&utm_medium=referral&utm_content=polyaxon/polyaxon&utm_campaign=Badge_Grade)
<a href="https://polyaxon.com"><img src="https://raw.githubusercontent.com/polyaxon/polyaxon/master/artifacts/logo/vector/primary-white-default-monochrome.svg" width="125" height="125" align="right" /></a>
# Reproduce, Automate, Scale your data science
Welcome to Polyaxon, a platform for building, training, and monitoring large scale deep learning applications.
We are making a system to solve reproducibility, automation, and scalability for machine learning applications.
Polyaxon deploys into any data center, cloud provider, or can be hosted and managed by Polyaxon, and it supports all the major deep learning frameworks such as Tensorflow, MXNet, Caffe, Torch, etc.
Polyaxon makes it faster, easier, and more efficient to develop deep learning applications by managing workloads with smart container and node management. And it turns GPU servers into shared, self-service resources for your team or organization.
<br>
<p align="center">
<img src="https://raw.githubusercontent.com/polyaxon/polyaxon/master/artifacts/demo.gif" alt="demo" width="80%">
</p>
<br>
# Install
#### TL;DR;
* Install CLI
```bash
# Install Polyaxon CLI
$ pip install -U polyaxon
```
* Create a deployment
```bash
# Create a namespace
$ kubectl create namespace polyaxon
# Add Polyaxon charts repo
$ helm repo add polyaxon https://charts.polyaxon.com
# Deploy Polyaxon
$ polyaxon admin deploy -f config.yaml
# Access API
$ polyaxon port-forward
```
Please check [polyaxon installation guide](https://polyaxon.com/docs/setup/)
# Quick start
#### TL;DR;
* Start a project
```bash
# Create a project
$ polyaxon project create --name=quick-start --description='Polyaxon quick start.'
```
* Train and track logs & resources
```bash
# Upload code and start experiments
$ polyaxon run -f experiment.yaml -u -l
```
* Dashboard
```bash
# Start Polyaxon dashboard
$ polyaxon dashboard
Dashboard page will now open in your browser. Continue? [Y/n]: y
```
<br>
<p align="center">
<img src="https://raw.githubusercontent.com/polyaxon/polyaxon/master/artifacts/compare.png" alt="compare" width="400">
<img src="https://raw.githubusercontent.com/polyaxon/polyaxon/master/artifacts/dashboards.png" alt="dashboards" width="400">
</p>
<br>
* Notebook
```bash
# Start Jupyter notebook for your project
$ polyaxon run --hub notebook
```
<br>
<p align="center">
<img src="https://raw.githubusercontent.com/polyaxon/polyaxon/master/artifacts/notebook.png" alt="compare" width="400">
</p>
<br>
* Tensorboard
```bash
# Start TensorBoard for a run's output
$ polyaxon run --hub tensorboard -P uuid=UUID
```
<br>
<p align="center">
<img src="https://raw.githubusercontent.com/polyaxon/polyaxon/master/artifacts/tensorboard.png" alt="tensorboard" width="400">
</p>
<br>
Please check our [quick start guide](https://polyaxon.com/docs/intro/quick-start/) to start training your first experiment.
# Distributed job
Polyaxon supports and simplifies distributed jobs.
Depending on the framework you are using, you need to deploy the corresponding operator, adapt your code to enable the distributed training,
and update your polyaxonfile.
Here are some examples of using distributed training:
* [Distributed Tensorflow](https://polyaxon.com/docs/experimentation/distributed/tf-jobs/)
* [Distributed Pytorch](https://polyaxon.com/docs/experimentation/distributed/pytorch-jobs/)
* [Distributed MPI](https://polyaxon.com/docs/experimentation/distributed/mpi-jobs/)
* [Horovod](https://polyaxon.com/integrations/horovod/)
* [Ray](https://polyaxon.com/docs/experimentation/distributed/ray-jobs/)
* [Dask](https://polyaxon.com/docs/experimentation/distributed/dask-jobs/)
# Hyperparameters tuning
Polyaxon has a concept for suggesting hyperparameters and managing their results very similar to Google Vizier called experiment groups.
An experiment group in Polyaxon defines a search algorithm, a search space, and a model to train.
* [Grid search](https://polyaxon.com/docs/automation/optimization-engine/grid-search/)
* [Random search](https://polyaxon.com/docs/automation/optimization-engine/random-search/)
* [Hyperband](https://polyaxon.com/docs/automation/optimization-engine/hyperband/)
* [Bayesian Optimization](https://polyaxon.com/docs/automation/optimization-engine/bayesian-optimization/)
* [Hyperopt](https://polyaxon.com/docs/automation/optimization-engine/hyperopt/)
* [Custom Iterative Optimization](https://polyaxon.com/docs/automation/optimization-engine/iterative/)
# Parallel executions
You can run your processing or model training jobs in parallel, Polyaxon provides a [mapping](https://polyaxon.com/docs/automation/mapping/) abstraction to manage concurrent jobs.
# DAGs and workflows
[Polyaxon DAGs](https://polyaxon.com/docs/automation/flow-engine/) is a tool that provides container-native engine for running machine learning pipelines.
A DAG manages multiple operations with dependencies. Each operation is defined by a component runtime.
This means that operations in a DAG can be jobs, services, distributed jobs, parallel executions, or nested DAGs.
# Architecture
![Polyaxon architecture](artifacts/polyaxon_architecture.png)
# Documentation
Check out our [documentation](https://polyaxon.com/docs/) to learn more about Polyaxon.
# Dashboard
Polyaxon comes with a dashboard that shows the projects and experiments created by you and your team members.
To start the dashboard, just run the following command in your terminal
```bash
$ polyaxon dashboard -y
```
# Project status
Polyaxon is stable and it's running in production mode at many startups and Fortune 500 companies.
# Contributions
Please follow the contribution guide line: *[Contribute to Polyaxon](CONTRIBUTING.md)*.
# Research
If you use Polyaxon in your academic research, we would be grateful if you could cite it.
Feel free to [contact us](mailto:contact@polyaxon.com), we would love to learn about your project and see how we can support your custom need.
Raw data
{
"_id": null,
"home_page": "https://github.com/polyaxon/polyaxon",
"name": "polyaxon",
"maintainer": "Polyaxon, Inc.",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "contact@polyaxon.com",
"keywords": "polyaxon, aws, s3, microsoft, azure, google cloud storage, gcs, deep-learning, machine-learning, data-science, neural-networks, artificial-intelligence, ai, reinforcement-learning, kubernetes, aws, microsoft, azure, google cloud, tensorFlow, pytorch",
"author": "Polyaxon, Inc.",
"author_email": "contact@polyaxon.com",
"download_url": "https://files.pythonhosted.org/packages/26/84/65d0812143790bb868f1f4590b77551e036d45d350db2f4d615ce60e5712/polyaxon-2.5.2.tar.gz",
"platform": "any",
"description": "[![License: Apache 2](https://img.shields.io/badge/License-apache2-blue.svg?style=flat&longCache=true)](LICENSE)\n[![Polyaxon API](https://img.shields.io/docker/pulls/polyaxon/polyaxon-api)](https://hub.docker.com/r/polyaxon/polyaxon-api)\n[![Slack](https://img.shields.io/badge/Slack-1.5k%20members-blue.svg?style=flat&logo=slack&longCache=true)](https://polyaxon.com/slack/)\n\n[![Docs](https://img.shields.io/badge/docs-stable-brightgreen.svg?style=flat&longCache=true)](https://polyaxon.com/docs/)\n[![Release](https://img.shields.io/badge/release-v2.5.2-brightgreen.svg?longCache=true)](https://polyaxon.com/docs/releases/2-5/)\n[![GitHub](https://img.shields.io/badge/issue_tracker-github-blue?style=flat&logo=github&longCache=true)](https://github.com/polyaxon/polyaxon/issues)\n[![GitHub](https://img.shields.io/badge/roadmap-github-blue?style=flat&logo=github&longCache=true)](https://github.com/orgs/polyaxon/projects/5)\n\n[![CLI](https://github.com/polyaxon/cli/actions/workflows/cli.yml/badge.svg)](https://github.com/polyaxon/cli/actions/workflows/cli.yml)\n[![Polyaxon](https://github.com/polyaxon/polyaxon/actions/workflows/cli.yml/badge.svg)](https://github.com/polyaxon/polyaxon/actions/workflows/cli.yml)\n[![Haupt](https://github.com/polyaxon/polyaxon/actions/workflows/haupt.yml/badge.svg)](https://github.com/polyaxon/polyaxon/actions/workflows/haupt.yml)\n[![Hypertune](https://github.com/polyaxon/polyaxon/actions/workflows/hypertune.yml/badge.svg)](https://github.com/polyaxon/polyaxon/actions/workflows/hypertune.yml)\n[![Traceml](https://github.com/polyaxon/polyaxon/actions/workflows/traceml.yml/badge.svg)](https://github.com/polyaxon/polyaxon/actions/workflows/traceml.yml)\n[![Codacy Badge](https://api.codacy.com/project/badge/Grade/90c05b6b112548c1a88b950beceacb69)](https://www.codacy.com/app/polyaxon/polyaxon?utm_source=github.com&utm_medium=referral&utm_content=polyaxon/polyaxon&utm_campaign=Badge_Grade)\n\n\n<a href=\"https://polyaxon.com\"><img src=\"https://raw.githubusercontent.com/polyaxon/polyaxon/master/artifacts/logo/vector/primary-white-default-monochrome.svg\" width=\"125\" height=\"125\" align=\"right\" /></a>\n\n# Reproduce, Automate, Scale your data science\n\n\nWelcome to Polyaxon, a platform for building, training, and monitoring large scale deep learning applications.\nWe are making a system to solve reproducibility, automation, and scalability for machine learning applications.\n\nPolyaxon deploys into any data center, cloud provider, or can be hosted and managed by Polyaxon, and it supports all the major deep learning frameworks such as Tensorflow, MXNet, Caffe, Torch, etc.\n\nPolyaxon makes it faster, easier, and more efficient to develop deep learning applications by managing workloads with smart container and node management. And it turns GPU servers into shared, self-service resources for your team or organization.\n\n<br>\n<p align=\"center\">\n <img src=\"https://raw.githubusercontent.com/polyaxon/polyaxon/master/artifacts/demo.gif\" alt=\"demo\" width=\"80%\">\n</p>\n<br>\n\n# Install\n\n#### TL;DR;\n\n* Install CLI\n\n ```bash\n # Install Polyaxon CLI\n $ pip install -U polyaxon\n ```\n\n * Create a deployment\n\n ```bash\n # Create a namespace\n $ kubectl create namespace polyaxon\n\n # Add Polyaxon charts repo\n $ helm repo add polyaxon https://charts.polyaxon.com\n\n # Deploy Polyaxon\n $ polyaxon admin deploy -f config.yaml\n\n # Access API\n $ polyaxon port-forward\n ```\n\nPlease check [polyaxon installation guide](https://polyaxon.com/docs/setup/)\n\n# Quick start\n\n#### TL;DR;\n\n * Start a project\n\n ```bash\n # Create a project\n $ polyaxon project create --name=quick-start --description='Polyaxon quick start.'\n ```\n\n * Train and track logs & resources\n\n ```bash\n # Upload code and start experiments\n $ polyaxon run -f experiment.yaml -u -l\n ```\n\n * Dashboard\n\n ```bash\n # Start Polyaxon dashboard\n $ polyaxon dashboard\n\n Dashboard page will now open in your browser. Continue? [Y/n]: y\n ```\n\n<br>\n<p align=\"center\">\n <img src=\"https://raw.githubusercontent.com/polyaxon/polyaxon/master/artifacts/compare.png\" alt=\"compare\" width=\"400\">\n <img src=\"https://raw.githubusercontent.com/polyaxon/polyaxon/master/artifacts/dashboards.png\" alt=\"dashboards\" width=\"400\">\n</p>\n<br>\n\n * Notebook\n ```bash\n # Start Jupyter notebook for your project\n $ polyaxon run --hub notebook\n ```\n\n<br>\n<p align=\"center\">\n <img src=\"https://raw.githubusercontent.com/polyaxon/polyaxon/master/artifacts/notebook.png\" alt=\"compare\" width=\"400\">\n</p>\n<br>\n\n * Tensorboard\n ```bash\n # Start TensorBoard for a run's output\n $ polyaxon run --hub tensorboard -P uuid=UUID\n ```\n\n<br>\n<p align=\"center\">\n <img src=\"https://raw.githubusercontent.com/polyaxon/polyaxon/master/artifacts/tensorboard.png\" alt=\"tensorboard\" width=\"400\">\n</p>\n<br>\n\nPlease check our [quick start guide](https://polyaxon.com/docs/intro/quick-start/) to start training your first experiment.\n\n# Distributed job\n\nPolyaxon supports and simplifies distributed jobs.\nDepending on the framework you are using, you need to deploy the corresponding operator, adapt your code to enable the distributed training,\nand update your polyaxonfile.\n\nHere are some examples of using distributed training:\n\n * [Distributed Tensorflow](https://polyaxon.com/docs/experimentation/distributed/tf-jobs/)\n * [Distributed Pytorch](https://polyaxon.com/docs/experimentation/distributed/pytorch-jobs/)\n * [Distributed MPI](https://polyaxon.com/docs/experimentation/distributed/mpi-jobs/)\n * [Horovod](https://polyaxon.com/integrations/horovod/)\n * [Ray](https://polyaxon.com/docs/experimentation/distributed/ray-jobs/)\n * [Dask](https://polyaxon.com/docs/experimentation/distributed/dask-jobs/)\n\n# Hyperparameters tuning\n\nPolyaxon has a concept for suggesting hyperparameters and managing their results very similar to Google Vizier called experiment groups.\nAn experiment group in Polyaxon defines a search algorithm, a search space, and a model to train.\n\n * [Grid search](https://polyaxon.com/docs/automation/optimization-engine/grid-search/)\n * [Random search](https://polyaxon.com/docs/automation/optimization-engine/random-search/)\n * [Hyperband](https://polyaxon.com/docs/automation/optimization-engine/hyperband/)\n * [Bayesian Optimization](https://polyaxon.com/docs/automation/optimization-engine/bayesian-optimization/)\n * [Hyperopt](https://polyaxon.com/docs/automation/optimization-engine/hyperopt/)\n * [Custom Iterative Optimization](https://polyaxon.com/docs/automation/optimization-engine/iterative/)\n\n# Parallel executions\n\nYou can run your processing or model training jobs in parallel, Polyaxon provides a [mapping](https://polyaxon.com/docs/automation/mapping/) abstraction to manage concurrent jobs.\n\n# DAGs and workflows\n\n[Polyaxon DAGs](https://polyaxon.com/docs/automation/flow-engine/) is a tool that provides container-native engine for running machine learning pipelines.\nA DAG manages multiple operations with dependencies. Each operation is defined by a component runtime.\nThis means that operations in a DAG can be jobs, services, distributed jobs, parallel executions, or nested DAGs.\n\n\n# Architecture\n\n![Polyaxon architecture](artifacts/polyaxon_architecture.png)\n\n# Documentation\n\nCheck out our [documentation](https://polyaxon.com/docs/) to learn more about Polyaxon.\n\n# Dashboard\n\nPolyaxon comes with a dashboard that shows the projects and experiments created by you and your team members.\n\nTo start the dashboard, just run the following command in your terminal\n\n```bash\n$ polyaxon dashboard -y\n```\n\n# Project status\n\nPolyaxon is stable and it's running in production mode at many startups and Fortune 500 companies.\n\n# Contributions\n\nPlease follow the contribution guide line: *[Contribute to Polyaxon](CONTRIBUTING.md)*.\n\n\n# Research\n\nIf you use Polyaxon in your academic research, we would be grateful if you could cite it.\n\nFeel free to [contact us](mailto:contact@polyaxon.com), we would love to learn about your project and see how we can support your custom need.\n\n\n",
"bugtrack_url": null,
"license": "Apache 2.0",
"summary": "Command Line Interface (CLI) and client to interact with Polyaxon API.",
"version": "2.5.2",
"project_urls": {
"Homepage": "https://github.com/polyaxon/polyaxon"
},
"split_keywords": [
"polyaxon",
" aws",
" s3",
" microsoft",
" azure",
" google cloud storage",
" gcs",
" deep-learning",
" machine-learning",
" data-science",
" neural-networks",
" artificial-intelligence",
" ai",
" reinforcement-learning",
" kubernetes",
" aws",
" microsoft",
" azure",
" google cloud",
" tensorflow",
" pytorch"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "cd7e860ce24ed3598ec1c7f54f7322f57394323c4d59807df72fcf99963d133e",
"md5": "f620e73b4d3fd2143745a7f63f2c130f",
"sha256": "8e2253e98ba14836bd2bf8967ecc619772e7ec3350978251c1ad7b91e91b8ed7"
},
"downloads": -1,
"filename": "polyaxon-2.5.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f620e73b4d3fd2143745a7f63f2c130f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 698926,
"upload_time": "2024-11-15T15:34:33",
"upload_time_iso_8601": "2024-11-15T15:34:33.535705Z",
"url": "https://files.pythonhosted.org/packages/cd/7e/860ce24ed3598ec1c7f54f7322f57394323c4d59807df72fcf99963d133e/polyaxon-2.5.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "268465d0812143790bb868f1f4590b77551e036d45d350db2f4d615ce60e5712",
"md5": "9b5d98493922933fcac4660430062c3b",
"sha256": "abd0a067d9c7f2372a12368618884140965d2c864a8e9ad8b2b911b9cd2528d7"
},
"downloads": -1,
"filename": "polyaxon-2.5.2.tar.gz",
"has_sig": false,
"md5_digest": "9b5d98493922933fcac4660430062c3b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 451736,
"upload_time": "2024-11-15T15:34:35",
"upload_time_iso_8601": "2024-11-15T15:34:35.296015Z",
"url": "https://files.pythonhosted.org/packages/26/84/65d0812143790bb868f1f4590b77551e036d45d350db2f4d615ce60e5712/polyaxon-2.5.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-15 15:34:35",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "polyaxon",
"github_project": "polyaxon",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"lcname": "polyaxon"
}