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

# Tutorial

> A quick start that takes you from install to a cited research writeup.

This tutorial walks through one full pass of the Qualia loop: point the app at your data, ask a question in plain language, and end up with a notebook, a task graph, and a writeup whose every claim traces back to evidence. Each step below builds on the previous one, so you can follow it end to end in a single sitting.

<Steps>
  <Step title="Download Qualia">
    Get the desktop app from [quadrillion.io/download](https://quadrillion.io/download). See [Getting Started](/getting-started) for the per-platform install details and first-launch prompts.
  </Step>

  <Step title="Open your workspace">
    Launch Qualia and open the folder where your data lives, or connect to a remote workspace if the data sits on another machine. Any CSV, Parquet, Excel, or other data file in that folder is immediately available to the agent — there is no import or upload step.
  </Step>

  <Step title="Start with a prompt">
    Describe what you want in the chat box, for example *"explore sales\_q3.csv"*. If the file is not in your workspace yet, attach it with the paperclip, and if you would rather not start from a blank page, click one of the example prompts below the chat box.

    <Frame>
      <img src="https://mintcdn.com/quadrillionlabs/icWk9RY386Kkxcf-/images/tutorial/01.png?fit=max&auto=format&n=icWk9RY386Kkxcf-&q=85&s=0525811e68d56e7693e9e89baec7d958" alt="Empty Qualia workspace with the chat box and example prompt cards" width="2048" height="1259" data-path="images/tutorial/01.png" />
    </Frame>
  </Step>

  <Step title="Watch the analysis happen in a notebook">
    The agent loads your data and runs the analysis in a real Jupyter [notebook](/notebooks), narrating what it found in the chat panel as it goes. Every cell is normal, editable code: rerun it, change it, or add your own — and you can also just describe the change you want in chat and let the agent make it.

    <Frame>
      <img src="https://mintcdn.com/quadrillionlabs/icWk9RY386Kkxcf-/images/tutorial/02.png?fit=max&auto=format&n=icWk9RY386Kkxcf-&q=85&s=c64d9c634cae8bcea8a4a8cc1d12e3e2" alt="Agent writing and running notebook cells with a summary in the chat panel" width="2048" height="1230" data-path="images/tutorial/02.png" />
    </Frame>
  </Step>

  <Step title="Follow parallel work in the task map">
    For bigger questions the agent splits the work across [parallel agents](/agents#parallel-agents), each owning its own [tasks](/tasks). Open the task map with the waypoints button in the **Agents** section of the left sidebar to watch them run as a live graph, where boxes are tasks and claims and the lines between them are dependencies.

    <Tip>
      You can control the parallelism with the settings icon in the chat box, which sets how readily Qualia splits suitable work across agents — see [Research style](/chat-and-ai#parallelism).
    </Tip>

    <Frame>
      <img src="https://mintcdn.com/quadrillionlabs/icWk9RY386Kkxcf-/images/tutorial/03.png?fit=max&auto=format&n=icWk9RY386Kkxcf-&q=85&s=e0d3a8e1de9fb92806609ebdb308ab1c" alt="Task map showing tasks and claims as a live dependency graph" width="2048" height="1234" data-path="images/tutorial/03.png" />
    </Frame>
  </Step>

  <Step title="Run a skill">
    [Skills](/skills) are saved workflows you can invoke on demand instead of re-explaining a process every time. Press `/` in the chat box to see the selectable list, and start with one of Qualia's built-ins such as `/dataset-exploration` or `/optimize`.

    <Frame>
      <img src="https://mintcdn.com/quadrillionlabs/icWk9RY386Kkxcf-/images/tutorial/04.png?fit=max&auto=format&n=icWk9RY386Kkxcf-&q=85&s=2bf851805db12975af68791dbf92f45f" alt="Skill picker opened with the slash key in the chat box" width="756" height="1194" data-path="images/tutorial/04.png" />
    </Frame>

    You can also write your own skills, or import the ones you already have from Claude Code or Cursor. Browse everything you have — skills, [rules](/rules), [MCP servers](/mcp-integrations), and more — with the briefcase button in the top right of the window.

    <Frame>
      <img src="https://mintcdn.com/quadrillionlabs/icWk9RY386Kkxcf-/images/tutorial/05.png?fit=max&auto=format&n=icWk9RY386Kkxcf-&q=85&s=5b5f367c9b67234fc35d810cd3dc423a" alt="Skills library open in the Agent Customization tab" width="2048" height="1273" data-path="images/tutorial/05.png" />
    </Frame>
  </Step>

  <Step title="Get a research writeup">
    Ask in the chat to write up the findings, or click **Generate a writeup** when the agent offers it. You get a [writeup](/writeups) with findings, figures, and numbered citations, which you can edit alongside the notebook and export when it is ready to share.

    <Frame>
      <img src="https://mintcdn.com/quadrillionlabs/icWk9RY386Kkxcf-/images/tutorial/06.png?fit=max&auto=format&n=icWk9RY386Kkxcf-&q=85&s=8ec3bf194d9dc27c24f37d78272acb75" alt="Generated writeup with figures and numbered citations" width="2048" height="1279" data-path="images/tutorial/06.png" />
    </Frame>
  </Step>

  <Step title="Trace any claim to its evidence">
    Click a citation in the writeup to open the [knowledge graph](/knowledge), focused on the exact evidence behind that finding. Everything Qualia learns is stored there and persists across sessions, so later work builds on what earlier work established rather than rediscovering it.
  </Step>
</Steps>

## Next steps

* [Chat & AI](/chat-and-ai) — More on prompting and research style settings
* [Notebooks](/notebooks) — Cell operations, keyboard shortcuts, and exports
* [Tasks](/tasks) — Deep dive into the task system
* [Knowledge System](/knowledge) — Learn about claims and validation
* [Agents](/agents) — Running parallel experiments
* [Skills](/skills) — Save, write, and import reusable workflows
* [Writeups](/writeups) — Research documents with citations
* [Autonomous Mode](/autonomous-mode) — Extended independent work with Slack updates
* [Rules](/rules) — Add persistent instructions to guide AI behavior
* [Settings](/settings/overview) — Configure models, appearance, and more