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

# Create Runtime

> Create a new agent runtime from a template

```python theme={null}
from gravixlayer import GravixLayer

client = GravixLayer()

runtime = client.runtime.create(
    template="python-3.14-base-small",
    env_vars={"APP_ENV": "production"},
    metadata={"project": "my-agent"},
)

print(runtime.runtime_id)
print(runtime.status)
print(runtime.template)

# Clean up when done
runtime.kill()
```

## Parameters

| Parameter         | Type    | Required | Description                                     |
| ----------------- | ------- | -------- | ----------------------------------------------- |
| `template`        | string  | Yes      | Template name (e.g. `python-3.14-base-small`)   |
| `timeout`         | integer | No       | Runtime timeout in seconds                      |
| `env_vars`        | object  | No       | Environment variables injected into the runtime |
| `metadata`        | object  | No       | User-defined metadata                           |
| `internet_access` | boolean | No       | Enable internet access                          |
| `provider`        | string  | No       | Cloud provider (`azure`, `aws`, `gcp`)          |
| `region`          | string  | No       | Region (`eastus2`, `us-east-1`)                 |

## Response

| Field          | Type    | Description                            |
| -------------- | ------- | -------------------------------------- |
| `runtime_id`   | string  | Unique runtime identifier              |
| `status`       | string  | Runtime status (`creating`, `running`) |
| `template`     | string  | Template used                          |
| `provider`     | string  | Cloud provider                         |
| `region`       | string  | Region                                 |
| `started_at`   | string  | Start timestamp                        |
| `timeout_at`   | string  | Timeout timestamp                      |
| `cpu_count`    | integer | vCPU count                             |
| `memory_mb`    | integer | Memory in MB                           |
| `disk_size_mb` | integer | Disk size in MB                        |