Python SDK

vly Python SDK — sync + async clients, full type hints, automatic retries.

The official Python SDK. Sync and async clients, type hints throughout, automatic retries on transient errors.

Install

pip install vly

Requires Python 3.10+.

Quick start

import os
from vly import Vly

vly = Vly(api_key=os.environ["VLY_API_KEY"])

# List projects
projects = vly.projects.list(limit=20).data

# Create a project
project = vly.projects.create(
    name="Tasks for teams",
    prompt="A real-time task tracker...",
    agent="claude-code",
)

# Trigger an agent run and stream output
run = vly.agents.run(project_id=project.id, prompt="Add a settings page")
for chunk in run.stream():
    print(chunk)

Async client

from vly import AsyncVly

async with AsyncVly(api_key=os.environ["VLY_API_KEY"]) as vly:
    project = await vly.projects.create(name="...", prompt="...")
    async for chunk in (await vly.agents.run(project_id=project.id, prompt="...")).stream():
        print(chunk)

Pagination

for project in vly.projects.iterate(limit=100):
    print(project.name)

Error handling

from vly import VlyError

try:
    vly.projects.create(name="...", prompt="...")
except VlyError as err:
    print(err.code, err.message)
    if err.code == "key_rate_limited":
        # wait and retry
        pass

Related

TypeScript SDK

Same surface, TypeScript.

CLI

Terminal access.

Webhooks SDK

Signature verification.