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.
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.tomlwith a[project]table: Qualia installs it with uv, using the locked versions inuv.lockif one exists. Set the Python version withrequires-pythonor.python-version.requirements.txt: Qualia installs the listed packages.- Neither: Qualia creates an empty environment that can run notebooks.
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.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 containKEY, 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_, orMODAL_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.
- Open the account menu at the bottom of the Settings sidebar and choose Verify email.
- Open the link Qualia emails you while signed in to the same account.
Related settings
- Editor settings: code editing preferences
- Agent settings: agent behavior and notifications
- Kernel toolbar: kernel controls in notebooks

