Skip to main content
Use Settings > General to choose how workspaces open, which language Qualia replies in, and how the desktop app updates. This page also covers Settings > Environments, where you pick the interpreters and shell your workspace uses, and email verification for Qualia Cloud.

Layout mode

Choose how every workspace opens:
  • Chat-first (default) centers on managing agents. Files and knowledge open beside the chat as they come up. Click Show files in the chat header to see the files an agent worked on.
  • Editor-first centers on editing files, with agents working around your project, as in an IDE.
The setting applies to every workspace. The desktop app and Qualia Cloud keep separate layout settings, so you can work editor-first on desktop and chat-first in the cloud. In the cloud, the setting follows you to other browsers and devices.

Response language

Response language sets the language agents reply in. Auto (system default) matches your system language, or you can pick one, such as Español or 日本語. This setting changes agent replies, not the app’s interface language.

Updates

Check for updates automatically is on by default on the desktop app. Turn it off to stop background checks, or click Check now to look for an update at any time. You can also choose Qualia > Check for Updates… on macOS, or Help > Check for Updates… on Windows and Linux. When an update is available, choose Download, then Restart to install it. In Qualia Cloud, an open tab shows A new version is available when Qualia updates. Click Refresh to load it.

Python environment

The interpreter settings live in Settings > Environments > Interpreters. They appear on the desktop app when a workspace is open, because Qualia Cloud manages environments for you. Default Python Environment sets the interpreter for new notebooks. Pick from the Python installations Qualia detects, such as Homebrew, pyenv, Conda, and virtual environments. To choose the kernel for notebooks that don’t have a saved kernel, use Settings > Notebooks > Default Kernel. See Set the default kernel.

Create a virtual environment

To give your workspace its own Python environment, click Create .venv under Workspace virtual environment. Qualia creates .venv in the workspace root, installs your project’s dependencies, and selects the new environment. The row describes what the button will do before you click it. Qualia reads dependencies from the workspace root:
  • pyproject.toml with a [project] table: Qualia installs it with uv, using the locked versions in uv.lock if one exists. Set the Python version with requires-python or .python-version.
  • requirements.txt: Qualia installs the listed packages.
  • Neither: Qualia creates an empty environment that can run notebooks.
If uv isn’t installed, Qualia skips pyproject.toml dependencies and warns you.
Running uv sync yourself later removes ipykernel, because your project doesn’t declare it. Qualia marks the environment ipykernel missing and reinstalls it when you select it again. To keep it, run uv add --dev ipykernel.
To remove the environment, click Delete .venv.

Julia and R environments

Julia Environment and R Environment set the installations Qualia uses for Julia and R notebooks, such as a Juliaup version or a system R. Their kernels appear in the kernel picker in their own groups. To have Qualia search more folders for kernels and environments, add them under Settings > Environments > Kernel discovery.

Terminal shell

On the desktop app, set Settings > Environments > Terminal > Terminal shell to the shell new terminals use, such as /bin/zsh or cmd.exe. See Choose a shell.

Environment variables in kernels and shell commands

On the desktop app, kernels, terminals, and agent shell commands inherit your environment. Qualia withholds variables whose names contain KEY, SECRET, TOKEN, PASSWORD, or CREDENTIAL, so that your credentials never reach child processes by accident. If your code needs one of those variables, such as MY_SITE_TOKEN, add its name under Settings > Environments > Secret passthrough. This setting is desktop-only.

Environment profiles

A profile is a named set of environment variables that Qualia applies to kernels, terminals, and agent shell commands. Manage profiles under Settings > Environments > Environment profiles.
  • To create one, choose New profile, then Add variable.
  • Qualia applies only profiles you created or chose for a workspace.
  • Organization admins can choose New organization profile to share one with the whole organization.
  • Names that start with QUALIA_, QUADRILLION_, KERNEL_, or MODAL_ are reserved. Qualia removes them and tells you which.

Delete workspace data

Settings > Workspace data > Delete workspace data stops and deletes every agent in the open workspace, with its chat history, and deletes all tasks and knowledge. Files stay.

Notifications

To choose when Qualia notifies you about agents, see Agent settings.

Account

Open the account menu at the bottom of the Settings sidebar to sign in, sign out, or manage sessions. See Sign-in and API keys for details.

Verify your email

Email verification applies to Qualia Cloud.
Signing in with Google, or with your organization’s single sign-on on a domain it has verified, proves your address. GitHub, Apple, and organization guest sign-ins show an Unverified badge until you verify.
  1. Open the account menu at the bottom of the Settings sidebar and choose Verify email.
  2. Open the link Qualia emails you while signed in to the same account.
If you open the link while signed in to a different account, choose Switch Account on the page that appears. The link works for 24 hours, and only the newest link you requested works. Verification matters for shared workspaces. You need a verified address to share a workspace, and a workspace shared with your address opens only after you verify it. If a shared workspace prompted the verification, confirming the link takes you straight to it.