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

# Quickstart

> Create an account, install the CLI or VS Code extension, and run your first job

## 1. Create an account

Sign up at the [Lyceum Cloud Dashboard](https://dashboard.lyceum.technology) and verify a payment card (there's no charge until you add credits, and you pay only for what you use). An [organization](/docs/account/organizations) is created automatically as your default, every run, VM, and credit lives there until you create or join more orgs. See [Billing](/docs/account/billing) for how credits work.

## 2. Pick how you want to access the platform

<Tabs>
  <Tab title="CLI" icon="terminal">
    ### Install the CLI

    The CLI is published as the `lyceum` binary. Install with pip:

    ```bash theme={null}
    pip install lyceum-cli
    ```

    ### Log in

    ```bash theme={null}
    lyceum auth login
    ```

    You'll be prompted for your email and password. The command exchanges those for a JWT token stored locally.

    <Tip>
      For long-running scripts and CI, generate an API key instead, see [API Keys](/docs/configuration/api-keys).
    </Tip>

    ### Run your first job

    Run a one-liner on the platform:

    ```bash theme={null}
    lyceum python run "print('Hello from Lyceum')"
    ```

    Run a Python file with a specific machine type:

    ```bash theme={null}
    lyceum python run script.py --machine gpu.a100
    ```
  </Tab>

  <Tab title="VS Code Extension" icon="code">
    ### Install the extension

    1. Open VS Code
    2. Open the Extensions view (Cmd/Ctrl+Shift+X)
    3. Search for **Lyceum Cloud**
    4. Install the official extension published by `lyceumtechnology`

    ### Authenticate

    1. Open any `.py` or `.ipynb` file
    2. Click the cloud icon in the editor toolbar
    3. The extension opens the dashboard for sign-in and redirects back to VS Code

    ### Run code

    With a Python file open, click the cloud icon (or run the **Lyceum Cloud: Execute on Cloud** command). The current file is submitted as a run and streamed back into VS Code.
  </Tab>

  <Tab title="REST API" icon="play">
    ### Get an API key

    1. Open the [Lyceum Cloud Dashboard](https://dashboard.lyceum.technology)
    2. Go to **API Keys**
    3. Click **New API Key**, pick the organization to scope it to, give it a name, optionally set an expiration
    4. Copy the key (starts with `lk_`), it's only shown once

    API keys are tied to one organization at creation time. Requests made with the key are billed and authorized against that org.

    <Warning>
      API keys grant full access to your account. Store them in a secret manager and never commit them to source control.
    </Warning>

    ### Make a request

    The API base is `https://api.lyceum.technology/api/v2/external`. Authentication is `Authorization: Bearer <key>`.

    ```bash theme={null}
    curl https://api.lyceum.technology/api/v2/external/billing/credits \
      -H "Authorization: Bearer lk_your_api_key"
    ```

    See the [API Reference](/api-reference/introduction) for the full endpoint list.
  </Tab>
</Tabs>

## 3. Where to next

<Columns cols={2}>
  <Card title="Launch a run" icon="play" href="/docs/serverless/launch-run">
    Submit Python or Docker workloads to GPU machines.
  </Card>

  <Card title="Launch an instance" icon="server" href="/docs/instances/launch">
    Provision a dedicated GPU VM with SSH access.
  </Card>

  <Card title="Deploy a model" icon="microchip" href="/docs/inference/dedicated">
    Stand up a Hugging Face model behind an OpenAI-compatible endpoint.
  </Card>

  <Card title="Upload files" icon="cloud-arrow-up" href="/docs/configuration/storage">
    Use your per-user S3 bucket for inputs and outputs.
  </Card>
</Columns>

<Note>
  Need help? Email [support@lyceum.technology](mailto:support@lyceum.technology).
</Note>