> For the complete documentation index, see [llms.txt](https://docs.nuvolos.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nuvolos.com/getting-started/choose-your-role.md).

# Choose your role

Nuvolos is designed for three primary audiences. Pick the path that matches your role to find your specific tutorials and how-to guides:

### 🎓 Instructors

Set up courses, distribute materials, manage assignments, and invite students.

* Tutorials
  * [Your first course on Nuvolos](/tutorials/tutorials-for-instructors/your-first-course-on-nuvolos.md)
  * [Running a data-heavy lab session](/tutorials/tutorials-for-instructors/running-a-data-heavy-lab-session.md)
  * [Reusing a course for the next term](/tutorials/tutorials-for-instructors/reusing-a-course-for-the-next-term.md)
* Guides
  * [Join an organisation](/how-to-guides/workflows-for-instructors/join-an-organisation.md) - accept an organisation-level invitation as Faculty or Manager so you can create your own courses.
  * [Create a new course](/how-to-guides/workflows-for-instructors/create-a-new-course.md) - set up a new course *Space* with name, description, and a starter *Application*.
  * [Add teaching material](/how-to-guides/workflows-for-instructors/add-teaching-material.md) - upload files into the *Master Instance* where you develop course content.
  * [Structure your course](/how-to-guides/workflows-for-instructors/best-practice-structuring-your-course.md) - choose the *Instance* layout that matches how students will work.
  * [Document your course](/how-to-guides/workflows-for-instructors/documenting-your-course.md) - use `README.md` files and embedded videos to introduce the course on its overview page.
  * [Invite students](/how-to-guides/workflows-for-instructors/invite-students.md) - send invitations so each student receives their own individual *Instance*.
  * [Invite teaching assistants and co-instructors](/how-to-guides/workflows-for-instructors/invite-tas.md) - invite colleagues as *Space Administrators* with full course management rights.
  * [Distribute teaching material](/how-to-guides/workflows-for-instructors/distribute-to-prospective-students.md) - push files, tables, or *Applications* from the *Master Instance* to every student.
  * [Set up group projects](/how-to-guides/workflows-for-instructors/setting-up-group-projects.md) - create per-group *Instances* in a separate group-work *Space*.
  * [Configure course tools and resources](/how-to-guides/workflows-for-instructors/configuring-student-applications.md) - manage *Applications* and resources for the entire cohort.
  * [GPU courses](/how-to-guides/workflows-for-instructors/courses-with-gpus.md) - enable GPU access, schedule lab sessions, or set up On-Demand GPU with *Credit* quotas.
  * [Assignments, grading, and feedback](/how-to-guides/workflows-for-instructors/setting-assignments.md) - create, distribute, grade, and hand back *Assignments*.
  * [Archiving your course](/how-to-guides/workflows-for-instructors/archiving-your-course.md) - manage the course archival lifecycle and access student work after archival.

### 📖 Students

Join a course, start *Applications*, and use *Snapshots* to save your work.

* Tutorials
  * [Your first Nuvolos session](/tutorials/tutorials-for-students/your-first-day-in-a-nuvolos-course.md)
  * [Submitting your first assignment](/tutorials/tutorials-for-students/submitting-your-first-assignment.md)
  * [Working on a group project](/tutorials/tutorials-for-students/working-on-a-group-project.md)
* Guides
  * [Accept a course invitation](/how-to-guides/workflows-for-students/join-a-course.md) - join a course by accepting the invitation email from your instructor.
  * [Find your course materials](/how-to-guides/workflows-for-students/find-your-course-materials.md) - locate the files, datasets, and *Applications* your instructor has distributed to you.
  * [Understand the course layout](/how-to-guides/workflows-for-students/understand-the-course-layout.md) - learn the difference between your personal *Instance* and the *Distributed Instance*.
  * [Use applications](/how-to-guides/workflows-for-students/start-an-application.md) - start and stop *Applications* like JupyterLab, RStudio, or VS Code.
  * [Work with files](/how-to-guides/workflows-for-students/work-with-files.md) - upload, download, edit, and organise files in your *Instance*.
  * [Complete and submit assignments](/how-to-guides/workflows-for-students/working-on-assignments.md) - work on *Assignments*, hand them in, and review instructor feedback.
  * [Save and recover work](/how-to-guides/workflows-for-students/snapshot-your-work.md) - take snapshots before major changes and restore previous states when needed.
  * [Collaborate and use special resources](/how-to-guides/workflows-for-students/working-with-a-gpu-in-a-course.md) - work in shared group *Instances* and use GPU access in your course.
  * [Working with archived courses](/how-to-guides/workflows-for-students/working-with-archived-courses.md) - access your work after a course is archived and restore from snapshots.
  * [Leaving a course](/how-to-guides/workflows-for-students/leaving-a-course.md) - remove yourself from a course while preserving your *Instance* and work.

### 🔬 Researchers

Create projects, manage data, run Applications, and collaborate with colleagues.

* Tutorials
  * [Your first research project](/tutorials/tutorials-for-researchers/your-first-research-project.md)
  * [From notebook to reproducible result](/tutorials/tutorials-for-researchers/from-notebook-to-reproducible-result.md)
  * [Reproducing a colleague's research project](/tutorials/tutorials-for-researchers/reproducing-a-colleagues-research-project.md)
* Guides
  * [Join an organization](/how-to-guides/workflows-for-researchers/join-an-organization.md) - accept an organisation-level invitation as Faculty or Manager so you can create your own projects.
  * [Create a research project](/how-to-guides/workflows-for-researchers/add-a-new-research-project.md) - set up a new research *Space* with the right visibility for your work.
  * [Join a research project](/how-to-guides/workflows-for-researchers/join-a-research-project.md) - accept an invitation to an existing project as *Space Administrator* or *Instance Editor*.
  * [Add material to the project](/how-to-guides/workflows-for-researchers/add-material-to-the-project.md) - bring files, code, and data into your project from local uploads, Git, or external storage.
  * [Create alternate approaches](/how-to-guides/workflows-for-researchers/create-alternate-approaches.md) - branch off into new *Instances* for parallel experimentation.
  * [Invite collaborators](/how-to-guides/workflows-for-researchers/invite-collaborators.md) - invite co-authors as *Space Administrators* or single-*Instance* contributors as *Instance Editors*.
  * [Invite an external reviewer](/how-to-guides/workflows-for-researchers/inviting-a-reviewer.md) - give a journal editor or reviewer an isolated copy of your work to inspect.
  * [Run analyses and applications](/how-to-guides/workflows-for-researchers/work-with-applications.md) - create, start, and stop *Applications* for your research.
  * [Set up a dataset](/how-to-guides/workflows-for-researchers/setting-up-a-dataset-on-nuvolos.md) - publish curated, vintaged data to a *Dataset Space*.
  * [Import data](/how-to-guides/workflows-for-researchers/importing-data-on-nuvolos.md) - bring external data into Nuvolos via uploads, downloads, mounts, or data pipelines.
  * [Database research workflow - Matlab & RStudio](/how-to-guides/workflows-for-researchers/a-complete-database-research-workflow-matlab-and-rstudio.md) - query the *Scientific Data Warehouse*, analyse in Matlab or RStudio, and write results back.
  * [GPU Computation](/how-to-guides/workflows-for-researchers/gpu-computation.md) - configure GPU sizes and install libraries for PyTorch, TensorFlow, or XGBoost.
  * [Scale and automate](/how-to-guides/workflows-for-researchers/scale-and-automate.md) - scale to HPC and automate workflows with the CLI or Python API.
  * [Preserve and share results](/how-to-guides/workflows-for-researchers/when-you-are-done-exporting.md) - export your project as a portable image and share snapshots with collaborators.