
# Qubernetes Studio (q8s-studio)

We are excited to introduce **Qubernetes Studio**, a GUI application designed to simplify the process of starting and managing Qubernetes Jupyter clusters. You can download the app from the [q8s-studio GitHub releases](https://github.com/torqs-project/q8s-studio/releases).

To ensure smooth operation, you need to have [Docker](https://www.docker.com/) installed and running on your local machine, as the app depends on the [q8s kernel](../jupyter/getting-started), which operates using Docker.

Qubernetes Studio is built using [Electron](https://www.electronjs.org/) for cross-platform desktop access and [React](https://reactjs.org/) for the UI development. Although the app is still in its early stages, we are actively adding new features and enhancing the user experience. We encourage feedback and contributions from the community to help us improve the application.

Thank you for your interest in Qubernetes Studio!

![Qubernetes Studio start screen](../studio/media/start-screen-many-environments.png)
*A screenshot from the starting screen of Qubernetes*


Introducing Qubernetes Studio, a GUI application for starting and managing Qubernetes Jupyter clusters.

A Grapghical User Interface for running Qubernetes


# Use images from private registries

We have introduced the option to execute quantum routines using images from private registries. To be able to use images from private registries, you need to authenticate with the registry. This can be done by creating a personal access token (PAT) and using it to authenticate with the registry.

The PAT can be passed to the `q8sctl execute` command using the `--registry-pat` flag:

```sh /--registry-pat/
q8sctl execute \
    --registry-pat PAT \
    --kubeconfig path-to-kubeconfig \
    --image image-name \
    program.py
```

or to Jupyter Lab as an environment variable `REGISTRY_PAT`:

```sh /REGISTRY_PAT/
REGISTRY_PAT=PAT jupyter lab
```

We have introduced the option to execute quantum routines using images from private registries. To be able to use images from private registries, you need to authenticate with the registry. This can be done by creating a personal access token (PAT) and using it to execute Python programs or Jupyter notebooks on the Qubernetes cluster.

Use images from private registries


# Run a Python program on Qubernetes

We have introduced  a new command `q8sctl execute` to run a Python program on Qubernetes. The command takes a Python script as an argument and executes it on the Qubernetes cluster. The script can be any Python program that you want to run on the cluster. The command will create a new job on the cluster and execute the script in a container.

```bash
q8sctl execute app.py --kubeconfig /path/to/config --image docker-image
```

We have introduced a new command `q8sctl execute` to run a Python program on Qubernetes. The command takes a Python script as an argument and executes it on the Qubernetes cluster. The script can be any Python program that you want to run on the cluster. The command will create a new job on the cluster and execute the script in a container.

Run a Python program on Qubernetes


# Environment variables for Jobs

We have introduced support for environment variables for the Jobs that you run on Qubernetes. Environment variables can be set in the `.env.q8s` file that should be placed in the root directory of the workspace.

```bash filename=".env.q8s" copy
export KEY=VALUE
```

They are available in the Jobs as regular environment variables and can be accessed in Jupyter cells or Python scripts using the `os.environ` dictionary. For example, the following Python script prints the value of the `KEY` environment variable:

```python
import os

print(os.environ['KEY'], None)
```

We have introduced support for environment variables for the Jobs that you run on Qubernetes. Environment variables can be set in the `.env.q8s` file that should be placed in the root directory of the workspace.

Changelog

A Grapghical User Interface for running Qubernetes

Use images from private registries

Run a Python program on Qubernetes

Environment variables for Jobs