> ## Documentation Index
> Fetch the complete documentation index at: https://docs.classiq.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Getting Started with Studio

The Studio is Classiq's browser-based development environment, giving you a ready-to-use workspace for writing and running quantum programs without any local installation.

## **Setup and Get Started**

To get started with the Studio, follow these steps:

1. Sign up for the platform: At [https://platform.classiq.io/](https://platform.classiq.io/), click Sign Up. Approve the terms of use and register with your Google/Microsoft account or any other email. If needed, fill in the registration form, and you'll be redirected to the home page.

2. Access the Studio from the platform home page using the sidebar button, as shown below.
   <img src="https://mintcdn.com/classiq/5Dl6k8R7l-F6gD4A/user-guide/studio/resources/studio_sidebar_button.png?fit=max&auto=format&n=5Dl6k8R7l-F6gD4A&q=85&s=70c66e0b82fe305974794a9cf563d907" alt="studio sidebar button" width="1213" height="793" data-path="user-guide/studio/resources/studio_sidebar_button.png" />

3. Your environment is loaded in a new browser tab (initial setup could take a couple of minutes). <img src="https://mintcdn.com/classiq/5Dl6k8R7l-F6gD4A/user-guide/studio/resources/loading_screen.png?fit=max&auto=format&n=5Dl6k8R7l-F6gD4A&q=85&s=334ecd8fc81284a12486d905b21bb426" alt="loading screen" width="1502" height="780" data-path="user-guide/studio/resources/loading_screen.png" />

4. Please trust the Classiq workspace author to open the Classiq extension and load your workspace. <img src="https://mintcdn.com/classiq/W-R807dENt_9x691/user-guide/studio/resources/trusted-host.png?fit=max&auto=format&n=W-R807dENt_9x691&q=85&s=e87209969570ed7b427973a14f135176" alt="trusted-host" width="1668" height="1016" data-path="user-guide/studio/resources/trusted-host.png" />

Now your Studio is ready for use.
Access your workspace via the "EXPLORER" icon on the top left.
Your workspace consists of two sections:

* Workspace: persistent storage; any edits you make are saved.
* Classiq library: This is your place to explore the world of quantum algorithms. You can click on any notebook, modify it, and run it. But remember that this is non-persistent storage: any edits to these files are reverted when the Studio is shut down (after 1 hour of being idle). If you've made changes you want to save, copy-paste the file to the personal workspace section.
  <img src="https://mintcdn.com/classiq/IRCgaMCeIzmIhMzn/user-guide/studio/resources/workspace_bright.png?fit=max&auto=format&n=IRCgaMCeIzmIhMzn&q=85&s=91e766fb7e58b3d285147fdf602dd5cd" alt="workspace_bright" className="block dark:hidden" width="2304" height="1211" data-path="user-guide/studio/resources/workspace_bright.png" />
  <img src="https://mintcdn.com/classiq/W-R807dENt_9x691/user-guide/studio/resources/workspace.png?fit=max&auto=format&n=W-R807dENt_9x691&q=85&s=e398db62b353bd1c00bf99ebae01580f" alt="workspace" className="hidden dark:block" width="1472" height="814" data-path="user-guide/studio/resources/workspace.png" />
* You can also upload any file into your persistent storage by right-clicking on "user workspace" and selecting "upload".
  <img src="https://mintcdn.com/classiq/IRCgaMCeIzmIhMzn/user-guide/studio/resources/upload-file-bright.png?fit=max&auto=format&n=IRCgaMCeIzmIhMzn&q=85&s=576fa942c60e7dbc0a54ed69c6bd6ade" alt="upload file at studio bright" className="block dark:hidden" width="3458" height="1746" data-path="user-guide/studio/resources/upload-file-bright.png" />
  <img src="https://mintcdn.com/classiq/W-R807dENt_9x691/user-guide/studio/resources/upload-file.png?fit=max&auto=format&n=W-R807dENt_9x691&q=85&s=a18bebd60f4a4654f2fdbb50ff86dc7a" alt="upload file at studio dark" className="hidden dark:block" width="1471" height="817" data-path="user-guide/studio/resources/upload-file.png" />

5. When running a notebook for the first time, you will be asked to install the kernel. Click on the "Select Kernel" button and choose the recommended Python kernel (Python 3.12.8).
   <img src="https://mintcdn.com/classiq/IRCgaMCeIzmIhMzn/user-guide/studio/resources/install-kernel-bright.png?fit=max&auto=format&n=IRCgaMCeIzmIhMzn&q=85&s=6712f2be2eb70a3ef1277fc0518cb139" alt="select correct kernel in studio bright" className="block dark:hidden" width="2304" height="1211" data-path="user-guide/studio/resources/install-kernel-bright.png" />
   <img src="https://mintcdn.com/classiq/W-R807dENt_9x691/user-guide/studio/resources/install-kernel.png?fit=max&auto=format&n=W-R807dENt_9x691&q=85&s=1849f4c6817e025dd4b4cfead1a51039" alt="select correct kernel in studio dark" className="hidden dark:block" width="3456" height="1740" data-path="user-guide/studio/resources/install-kernel.png" />
6. A drop-down menu appears; select "Python Environments" (or press "Enter").
7. Select "classiq-venv".
   * More advanced users who are comfortable managing their own environment are welcome to set up and use their own virtual environment.
8. Start coding, experiment, and create quantum algorithms.
9. When calling the method `show()` you might see a pop-up that asks you to trust an external domain - click on "trust all domains from classiq.io" to see this pop-up only once. The circuit will open up in a separate tab.

## **Best Practices**

In the Studio, each user has their own dedicated persistent storage (2 GB).
This means that every time you reload, you can keep working right where you left off, just as you would locally on your computer.

Keep the following considerations and best practices in mind:

### **Data Persistence**

#### **Location**

The explorer (file browser) is divided into two sections: Workspace and Classiq library. The Classiq library is non-persistent, and any edits to these files are reverted when the Studio is shut down (after 1 hour of being idle). Thus, we recommend copying the desired notebook to the Workspace section.

#### **Retention Period**

Please note that this feature is still under development, and we are working on improving it. Thus, we will do our best to keep your data and work safe, but we cannot guarantee that your data will be kept forever. We recommend backing up your work locally (by downloading the files) or in a remote repository.

### **Using Git**

We highly recommend using Git and GitHub (or similar) to keep track of your work. You can use Git in the terminal or in the Studio. Check out [this section](/user-guide/studio/git-getting-started) to get started with Git.
After committing locally, it's best to push your work into a remote repository for backup and collaborative work.

### **Using the Virtual Environment Wisely**

You have a virtual environment installed in your Studio. You can install any pip package you need for your work (e.g., Qiskit, TensorFlow, etc.), but keep in mind that you have limited space. Also, environments are often hard to maintain, and you can get into a dependency rabbit hole. If you want to experiment with new packages, create a new venv with whatever packages you need and delete it when you're done.
We guarantee that the "classiq-venv" is set and working.

#### **Resetting the Virtual Environment**

If you encounter issues or simply want a clean slate, you can reset your virtual environment by running the following command in the terminal:

```bash theme={null}
reset-user-env
```

Running this command will remove any additional packages or modifications
you've made in your virtual environment, restoring it to its default state.
This is especially useful if you experience dependency issues or if the environment becomes cluttered from experimentation.

> ***Pro Tip:*** To manually reset your virtual environment, you can run:
> `rm -rf /classiq-venv/*`

## **Pre-Installed LaTeX (latexmk)**

`latexmk` and a TeX Live subset (`texlive-latex-base`, `texlive-latex-recommended`, `texlive-latex-extra`, `texlive-fonts-recommended`, `texlive-science`) are pre-installed in the Studio. This means you can run the benchmarking application from the Classiq library and have it build its PDF report out of the box, without any additional setup.
