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

# Quickstart

> Build an Oxygen project locally, push it to GitHub, and deploy it to Oxygen Cloud

Oxygen is **code-first** — your project is a git repo, and git is the source of
truth. The fastest way to build is locally with the `oxy` CLI and the Oxygen skill
for Claude Code, then deploy by connecting your repo to Oxygen Cloud.

<Steps>
  <Step title="Install the Oxygen CLI">
    The install script downloads the right binary for your OS and drops it on
    your `PATH`:

    ```bash theme={null}
    bash <(curl -sSfL https://get.oxy.tech)
    ```

    Full details and first commands: [Install the CLI →](/docs/guide/start/install-cli).
  </Step>

  <Step title="Install the Oxygen skill for Claude Code">
    The Oxygen skill teaches Claude Code how to scaffold Oxygen files — your semantic
    model, agents, automations, and data apps — correctly:

    ```bash theme={null}
    /plugin marketplace add oxy-hq/skills
    /plugin install oxy-skills@oxy-hq
    ```
  </Step>

  <Step title="Build a working version locally">
    With the CLI and the skill in place, build your project: connect a data
    source, define your [semantic model](/docs/guide/build/semantic-model/simple-model),
    compose your [World Model](/docs/guide/build/world-model), and add an
    [agent](/docs/guide/build/agents). Preview it locally with `oxy start --local`
    until it answers questions the way you want.

    See [Connect your data →](/docs/guide/build/connect-data) and
    [Your first project →](/docs/guide/start/first-project).
  </Step>

  <Step title="Push to GitHub">
    Commit your project and push it to a GitHub repository. Because Oxygen is
    code-first, this repo *is* your project — Oxygen Cloud deploys from it.
  </Step>

  <Step title="Sign up and connect your repo">
    Go to [app.oxygen-hq.com](https://app.oxygen-hq.com), sign up, and create a
    workspace. Connect the GitHub repo you just pushed and Oxygen imports your
    project.

    See [GitHub integration →](/docs/guide/manage/workspaces/github-integration).
  </Step>

  <Step title="Re-add your secrets in the cloud">
    Secrets never live in git, so re-add them in the workspace after connecting:

    * **LLM key** — **Manage → Secrets**. Paste your OpenAI or Anthropic key so
      the agents can run. ([Secrets →](/docs/guide/manage/secrets))
    * **Data connections** — **Manage → Workspace → Connections**. Re-enter the
      warehouse credentials your project references and click **Test**.
      ([Connect your data →](/docs/guide/build/connect-data))

    The home page shows a green check next to "LLM key" once it's set.
  </Step>

  <Step title="Ask your first question">
    Open the chat panel on the home page, pick your agent, and ask a question
    about your data — for example:

    > How many orders did we get last week?

    Oxygen generates the SQL, runs it, and streams the answer back with the chart
    and the underlying query.
  </Step>
</Steps>

## Next steps

<CardGroup cols={2}>
  <Card title="The World Model" href="/docs/guide/build/world-model" />

  <Card title="Build an agent" href="/docs/guide/build/agents" />

  <Card title="Connect your data" href="/docs/guide/build/connect-data" />

  <Card title="The SDK" href="/docs/guide/build/sdk" />
</CardGroup>