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

# SDKs e CLI legados

<Warning>
  Esta página legada é mantida para usuários que ainda usam a linha de SDK 1.x ou beta. Novas integrações com o SDK 2.x devem seguir a documentação atual do Sandbox.
</Warning>

Esta página lista as versões legadas do SDK e da CLI do Novita Agent Sandbox para usuários que ainda precisam da linha de SDK 1.x estável ou 1.x beta.

## Versões legadas do SDK Novita

Se você precisa permanecer na linha legada do SDK 1.x, fixe explicitamente uma das seguintes versões:

| Pacote                    | Última versão estável 1.x  | Última versão beta 1.x       |
| ------------------------- | -------------------------- | ---------------------------- |
| Python SDK                | `novita-sandbox==1.0.5`    | `novita-sandbox==1.2.5b2`    |
| JavaScript/TypeScript SDK | `novita-sandbox@1.0.2`     | `novita-sandbox@1.2.3b1`     |
| CLI                       | `novita-sandbox-cli@1.0.4` | `novita-sandbox-cli@1.2.3b1` |

## Instalação

### Instalar o SDK estável legado

<CodeGroup>
  ```bash JavaScript & TypeScript icon="terminal" theme={"system"}
  npm i novita-sandbox@1.0.2
  ```

  ```bash Python icon="terminal" theme={"system"}
  pip install novita-sandbox==1.0.5
  ```
</CodeGroup>

### Instalar a CLI estável legada

<CodeGroup>
  ```bash Bash icon="terminal" theme={"system"}
  npm i -g novita-sandbox-cli@1.0.4
  ```
</CodeGroup>

### Instalar o SDK beta legado

<CodeGroup>
  ```bash JavaScript & TypeScript icon="terminal" theme={"system"}
  npm i novita-sandbox@1.2.3b1
  ```

  ```bash Python icon="terminal" theme={"system"}
  pip install novita-sandbox==1.2.5b2
  ```
</CodeGroup>

### Instalar a CLI beta legada

<CodeGroup>
  ```bash Bash icon="terminal" theme={"system"}
  npm i -g novita-sandbox-cli@1.2.3b1
  ```
</CodeGroup>

## Configuração

As versões legadas do SDK usam `sandbox.novita.ai` por padrão. Você só precisa configurar sua chave de API da Novita.

```bash Bash icon="terminal" theme={"system"}
export NOVITA_API_KEY="<Your Novita AI API Key>"
```

## Exemplos

Abaixo está um exemplo que mostra como criar um sandbox por meio do SDK e executar comandos especificados.

<CodeGroup>
  ```js JavaScript & TypeScript icon="js" theme={"system"}
  import { Sandbox } from 'novita-sandbox/code-interpreter'

  const sbx = await Sandbox.create()
  const execution = await sbx.commands.run('ls -l')
  console.log(execution)

  await sbx.kill()
  ```

  ```python Python icon="python" theme={"system"}
  from novita_sandbox.code_interpreter import Sandbox

  sbx = Sandbox.create()
  execution = sbx.commands.run('ls -l')
  print(execution)

  sbx.kill()
  ```
</CodeGroup>

Abaixo está um exemplo que mostra como usar a CLI do Novita Sandbox.

<CodeGroup>
  ```bash Bash icon="terminal" theme={"system"}
  # Authentication in CLI
  novita-sandbox-cli auth login

  # Start sandbox and connect to terminal
  novita-sandbox-cli sandbox spawn <template-id>

  # List sandboxes
  novita-sandbox-cli sandbox list

  # Shutdown running sandboxes
  novita-sandbox-cli sandbox kill <sandbox-id>
  ```
</CodeGroup>
