fleet-python 0.2.129

Python SDK for Fleet environments

Fleet SDK

The Fleet Python SDK provides programmatic access to Fleet's environment infrastructure.

Installation

Install the Fleet SDK using pip:

pip install fleet-python

Alpha/Pre-release Versions

To install the latest alpha or pre-release version:

pip install --pre fleet-python

To install a specific alpha version:

pip install fleet-python==0.2.64-alpha1

API Key Setup

Fleet requires an API key for authentication. You can obtain one from the Fleet Platform.

Set your API key as an environment variable:

export FLEET_API_KEY="sk_your_key_here"

Basic Usage

import fleet
import datetime

# Create environment by key
env = fleet.env.make("fira")

# Reset environment with seed and options
env.reset(
    seed=42,
    timestamp=int(datetime.datetime.now().timestamp())
)

# Access environment state ('current' is the resource id for a sqlite database)
sql = env.state("sqlite://current")
sql.exec("UPDATE customers SET status = 'active' WHERE id = 123")

# Clean up
env.close()

Environment Management

Creating Instances

# Create environment instance with explicit version
env = fleet.env.make("fira:v1.2.5")

# Create environment instance with default (latest) version
env = fleet.env.make("fira")

Connecting to Existing Instances

# Connect to a running instance
env = fleet.env.get("env_instance_id")

# List all running instances
instances = fleet.env.list_instances()
for instance in instances:
    print(f"Instance: {instance.instance_id}")
    print(f"Type: {instance.environment_type}")
    print(f"Status: {instance.status}")

# Filter instances by status (running, pending, stopped, error)
running_instances = fleet.env.list_instances(status_filter="running")

# List available environment types
available_envs = fleet.env.list_envs()