gravixlayer 0.1.1

GravixLayer Python SDK — agent runtimes and templates (Alpha; API may evolve). See docs.gravixlayer.ai.

GravixLayer Python SDK

Official Python client for GravixLayer — create and manage cloud agent runtimes and templates for your workloads.

Install

pip install gravixlayer

Configure

export GRAVIXLAYER_API_KEY="your-api-key"
export GRAVIXLAYER_CLOUD="azure"       # default
export GRAVIXLAYER_REGION="eastus2"    # default

Or pass options to the client:

from gravixlayer import GravixLayer

client = GravixLayer(
    api_key="your-api-key",
    base_url="https://app.gravixlayer.ai",
    cloud="azure",
    region="eastus2",
)

Quick start

from gravixlayer import GravixLayer

client = GravixLayer()
runtime = client.runtime.create(template="python-3.12-base-small")

result = client.runtime.run_code(
    runtime.runtime_id,
    code="print('Hello from GravixLayer')",
)
print(result.text)

client.runtime.kill(runtime.runtime_id)

Performance note (connections and HTTP/2)

The client uses HTTP/1.1 by default for predictable latency on typical API usage.

• Warm the connection before creating many runtimes: call client.warmup() once (or use warmup_on_init=True when constructing the client). That pays TCP, TLS, and protocol setup up front so the first real request is cheaper.
• HTTP/2: pass http2=True to GravixLayer(...) if you want multiplexing over a single established connection after TLS (useful for high concurrency). Requires the httpx[http2] extra (already declared by this package).

Sync:

from gravixlayer import GravixLayer

client = GravixLayer(http2=True)
client.warmup()
# or: GravixLayer(http2=True, warmup_on_init=True)

Async: pass http2=True to AsyncGravixLayer and call await client.warmup() before heavy traffic.

from gravixlayer import AsyncGravixLayer

async with AsyncGravixLayer(http2=True) as client:
    await client.warmup()

Async

import asyncio
from gravixlayer import AsyncGravixLayer

async def main():
    async with AsyncGravixLayer() as client:
        runtime = await client.runtime.create(template="python-3.12-base-small")
        await client.runtime.kill(runtime.runtime_id)

asyncio.run(main())

Documentation and examples

• Examples: examples/ (runtimes, templates, sample apps)
• Documentation: docs.gravixlayer.ai
• Issues: GitHub Issues

Support

[e-mail]

License

Apache License 2.0 — see LICENSE.
Copyright 2026 Gravix Layer.