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

# Get started with the Celesto SDK

> Install the Celesto SDK, authenticate with an API key, create your first sandboxed computer, run a command in it, and clean up the resources.

This quickstart creates one sandboxed computer, runs `uname -a`, prints the output, and deletes the computer. You can use the language selector to switch the whole example between Python and TypeScript.

## Before you start

Get an API key from [celesto.ai](https://celesto.ai) under **Settings > Security**. Set it as `CELESTO_API_KEY` before you run the examples.

<View title="Python" icon="python">
  ## Install the Python SDK

  ```bash theme={null}
  pip install -U celesto
  ```

  ## Run your first computer

  Create `quickstart.py`:

  ```python quickstart.py theme={null}
  import os

  from celesto import Computer


  if not os.environ.get("CELESTO_API_KEY"):
      raise RuntimeError("Set CELESTO_API_KEY before running this script.")

  computer = Computer(template_id="scratch")
  print(f"Computer ready: {computer.name}")

  result = computer.run("uname -a")
  print(result["stdout"].strip())

  computer.delete()
  ```

  Run it:

  ```bash theme={null}
  export CELESTO_API_KEY="your-api-key"
  python quickstart.py
  ```

  <Check>
    The script prints the computer name, prints Linux system information, and deletes the computer.
  </Check>

  ## Next step

  Learn how to [create computers with templates](/cloud/computers#use-a-template) when your agent needs coding tools already installed.
</View>

<View title="TypeScript" icon="js">
  ## Install the TypeScript SDK

  ```bash theme={null}
  npm install @celestoai/sdk@latest
  npm install --save-dev tsx typescript
  ```

  ## Run your first computer

  Create `quickstart.ts`:

  ```ts quickstart.ts theme={null}
  import { Computer } from "@celestoai/sdk";

  const token = process.env.CELESTO_API_KEY;
  if (!token) {
    throw new Error("Set CELESTO_API_KEY before running this script.");
  }

  const computer = await Computer.create({ templateId: "scratch" }, { token });
  console.log("Computer ready:", computer.name);

  const result = await computer.run("uname -a");
  console.log(result.stdout.trim());

  await computer.delete();
  ```

  Run it:

  ```bash theme={null}
  export CELESTO_API_KEY="your-api-key"
  npx tsx quickstart.ts
  ```

  <Check>
    The script prints the computer name, prints Linux system information, and deletes the computer.
  </Check>

  ## Next step

  Learn how to [create computers with templates](/cloud/computers#use-a-template) when your agent needs coding tools already installed.
</View>
