> 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. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.nuvolos.com/getting-started/choose-your-role.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.