Project in Polyaxon is very similar to a project in github,
it aims at organizing your efforts to solve a specific problem.
Create a project¶
To create a project, you can both use the Polyaxon Dashboard or the Polyaxon CLI.
The projects consist of a required argument
--name an optional argument
and a flag
--private with a default value set to
The projects could be
public (default behaviour) or
in that case only you i.e.
logged-in user, and
superusers can access the project.
Public projects are visible to everyone as read only mode, and read/write mode to the
More permissions and roles
More permissions and roles will be available, when we introduce teams. If you want to be notified when we release this feature, please subscribe to receive our progress.
Only the creator and superusers can create experiment groups and experiments
Even if you set your project to
public, only you, i.e. the
owner, and the
will be able to run experiments in this project.
public only gives read access to other users in your team.
$ polyaxon project create --name=mnist --description='Classification of handwritten images.'
For more details about this command please run
polyaxon project create --help,
or check the command reference
The project is created by default
public, to make it private please add
Initializing a project¶
After creating a project, you can start your experimentation process, and the first step is to initialize a workspace for your project on your workstation.
$ mkdir mnist $ cd mnist $ polyaxon init mnist Project `mnist` was initialized and Polyaxonfile was created successfully `polyaxonfile.yml`
When a project is initialized, polyaxon creates a default
you can customize it to ignore the files that you don't want to upload.
Now you can add some code to your project.
Before doing anything you must update the default polyaxonfile to tell polyaxon how to run your code
$ vi polyaxonfile.yml
Upload code for this project¶
Create the code you wish to run on Polyaxon, e.g.
$ vi train.py ...
Upload the code to polyaxon to commit this current version.
$ polyaxon upload [================================] 675/675 - 00:00:00 Files uploaded.
You are ready now to run experiments, please go to experiment groups if you want to run multiple experiments concurrently and perform hyperparameters search. Otherwise go to experiments if you want to run a single experiment.