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

# Novita sandboxes

> Run CostGraph workflows and CI jobs in Novita sandboxes: the key to create, its permissions, and its limits

Novita Sandbox is a managed, isolated, stateful execution environment for AI agents to run code, use browsers, work with files and preserve state across sessions.

The following table shows what CostGraph runs on this provider.

| Workflows | CI runners | Connect with |
| - | - | - |
| Yes | Yes | Integrations or your own dispatcher |

## Connect

Connect Novita on Integrations, and CostGraph starts sandboxes in your Novita account. You don't run anything yourself.

1. In CostGraph, go to **Integrations > Sandbox > Novita**.

2. Enter these fields:

   * **API key** (`NOVITA_API_KEY`, required): A Novita AI API key from Key Management in Novita settings.

3. Click **Connect**.

Sandbox size comes from the template set as `providerTemplate`.

### Your own dispatcher

To keep the key out of CostGraph or reach a private network, run your own dispatcher instead.
Set `provider` to `novita` and the preceding fields as environment variables, as described in [Run your own dispatcher](https://docs.costgraph.ai/costgraph/workflows/managed-sandboxes.md#run-your-own-dispatcher).

## Key and permissions

NOVITA\_API\_KEY is a Novita AI API key. View and manage keys on the settings page at novita.ai/settings/key-management. It is sent as a Bearer token.

The provider doesn't document key scopes or roles, so a key has full access to the account.

Sources: [novita.ai: sandbox overview](https://novita.ai/docs/guides/sandbox-overview.md), [novita.ai: basic authentication](https://novita.ai/docs/api-reference/basic-authentication.md), [novita.ai: sandbox quota limit](https://novita.ai/docs/guides/sandbox-quota-limit.md), [novita.ai: sandbox auto resume](https://novita.ai/docs/guides/sandbox-auto-resume.md).

## Limits

* Maximum session duration is 1 hour on Free, 3 hours on Paid, and 4 hours (adjustable) on Enterprise. ([source](https://novita.ai/docs/guides/sandbox-quota-limit.md))
* Concurrent sandboxes: 5 on Free, 100 on Paid, 500 on Enterprise. Max vCPU/memory: 2 vCPU/4 GiB on Free and 8 vCPU/8 GiB on Paid. Disk is 20 GB, with 0.5-4 GiB memory per vCPU. ([source](https://novita.ai/docs/guides/sandbox-quota-limit.md))
* Default lifetime (timeout) is 5 minutes, counted from creation regardless of activity. A separate idle timeout fires only when no client is connected. ([source](https://novita.ai/docs/guides/sandbox-auto-resume.md))
* The docs do not state regions or CPU architecture. ([source](https://novita.ai/docs/guides/sandbox-overview.md))

## Related

* [Supported sandbox providers](https://docs.costgraph.ai/costgraph/workflows/sandbox-providers.md)
* [Run workflows on a managed sandbox provider](https://docs.costgraph.ai/costgraph/workflows/managed-sandboxes.md)
* [Run CI jobs in sandboxes](https://docs.costgraph.ai/costgraph/autopilot/ci-sandboxes.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.