Try Qualia in your browser
Open Qualia Cloud to use Qualia without installing it. You can also choose Try Qualia on the Quadrillion website. Qualia Cloud sets up Python for you and runs your work on cloud compute.Download and install
Download the desktop app from the download page.- macOS
- Windows
- Linux
Qualia needs macOS 12 or later on an Apple Silicon Mac (M1 or newer). Intel Macs are not supported.
- Download the DMG, named
qualia-[VERSION]-macos-apple-silicon.dmg. - Open the DMG and drag Qualia to your Applications folder.
- Open Qualia. On first launch, macOS may ask you to confirm because you downloaded the app from the internet.
Sign in
On first launch, choose a Continue with option, or enter your work email and choose Continue with SSO. Qualia finishes sign-in in your browser and creates your account if you are new. On an enterprise deployment, choose enter your activation key instead. For every sign-in option, sessions, and your own provider keys, see Sign-in and API keys.Set up a Python kernel
A kernel is the process that runs your notebook code. During desktop onboarding, choose Install Jupyter to install a managed Python kernel that only Qualia uses. It leaves your other Python installs untouched, and it needs internet access to download packages. If you choose Skip for now, Qualia offers the install again on your next launch. Until then, you can connect to remote compute instead. To use your own Python environment or create a.venv for a project, see General settings.
If the installation fails, share the error shown under Failed with your IT team, or contact support at support@quadrillion.io.
Open a workspace
A workspace is the folder Qualia works in. Its files, agents, tasks, and knowledge belong to that workspace.- Desktop
- Qualia Cloud
On the welcome screen, pick a recent workspace, or choose one of these:
- New workspace… creates a folder, and you pick its name and location.
- Open folder… uses an existing folder.
- Add remote workspace… connects to Qualia running on another machine. See Connect to a remote backend.
Rename, delete, or leave a workspace
In Qualia Cloud, open a workspace card’s … menu to Rename or Delete your workspace, or Leave one someone shared with you. Stop any running agents first. Deleting a workspace permanently removes its files, chats, tasks, knowledge, and compute. Connected integrations stay on your account, and new conversations from them arrive in another workspace. If you can’t delete a workspace, its tooltip explains why. If Qualia can’t open a workspace link, it offers the next step, such as verifying your email, switching accounts, or returning to All workspaces. For sharing and roles, see Shared workspaces.Connect to a remote backend
To work on data that lives on another machine, run Qualia there and connect the desktop app to it. Save your open files first, because switching workspaces stops local work.- Open the workspace selector in the titlebar and choose Add remote workspace….
- Choose SSH Connection and enter the host, username, and private key path. Or choose Direct URL and enter the backend URL.
- Choose Connect and choose folder, then pick the folder on the remote machine to use as your workspace.
https:// unless the server is on localhost, such as a port you forwarded over SSH. Once connected, Open remote folder… lets you switch folders on that machine without restarting Qualia. To bring your saved keys along, see Import keys from this computer.
Run your first analysis
After onboarding, a welcome tour shows you how to ask a question, work with agents, and get a writeup. You can skip it, and replay it later from the Help menu.1
Create a notebook
In the Files sidebar, choose New file, then Notebook. Or open an existing
.ipynb file. See Notebooks.2
Ask the agent
Type a request in the chat panel, for example:
- “Load the iris dataset and show me a summary”
- “Train some CNNs on the MNIST dataset”
3
Review the results
Qualia writes code cells, runs them, and shows the output in the notebook, such as plots, tables, and text. You can read and edit every cell it creates.

