fleet-python 0.2.4__tar.gz → 0.2.7__tar.gz

{fleet_python-0.2.4/fleet_python.egg-info → fleet_python-0.2.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fleet-python
-Version: 0.2.4
+Version: 0.2.7
 Summary: Python SDK for Fleet environments
 Author-email: Fleet AI <nic@fleet.so>
 License: Apache-2.0
@@ -32,6 +32,7 @@ Requires-Dist: isort>=5.0.0; extra == "dev"
 Requires-Dist: mypy>=1.0.0; extra == "dev"
 Requires-Dist: ruff>=0.1.0; extra == "dev"
 Requires-Dist: unasync>=0.6.0; extra == "dev"
+Requires-Dist: python-dotenv>=1.1.1; extra == "dev"
 Provides-Extra: playwright
 Requires-Dist: playwright>=1.40.0; extra == "playwright"
 Dynamic: license-file
@@ -64,20 +65,20 @@ export FLEET_API_KEY="sk_your_key_here"
 import fleet as flt
 
 # Create environment by key
-env = await flt.env.make("fira")
+env = flt.env.make("fira")
 
 # Reset environment with seed and options
-await env.reset(
+env.reset(
     seed=42,
     timestamp=datetime.now()
 )
 
 # Access environment state ('crm' is the resource id for a sqlite database)
 sql = env.state("sqlite://crm")
-await sql.exec("UPDATE customers SET status = 'active' WHERE id = 123")
+sql.exec("UPDATE customers SET status = 'active' WHERE id = 123")
 
 # Clean up
-await env.close()
+env.close()
 ```
 
 ## Environment Management
@@ -86,10 +87,10 @@ await env.close()
 
 ```python
 # Create environment instance with explicit version
-env = await flt.env.make("fira:v1.2.5")
+env = flt.env.make("fira:v1.2.5")
 
 # Create environment instance with default (latest) version
-env = await flt.env.make("fira")
+env = flt.env.make("fira")
 
 ```
 
@@ -97,18 +98,59 @@ env = await flt.env.make("fira")
 
 ```python
 # Connect to a running instance
-env = await flt.env.get("env_instance_id")
+env = flt.env.get("env_instance_id")
 
 # List all running instances
-instances = await flt.env.list_instances()
+instances = flt.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 = await flt.env.list_instances(status_filter="running")
+running_instances = flt.env.list_instances(status_filter="running")
 
 # List available environment types
-available_envs = await flt.env.list_envs()
+available_envs = flt.env.list_envs()
 ```
+
+## Development
+
+### Code Structure
+
+This SDK uses `unasync` to maintain both async and sync versions of the code from a single source:
+
+- **`fleet/_async/`** - The source code (async version) - **EDIT THIS**
+- **`fleet/`** - The generated sync version - **DO NOT EDIT** (auto-generated)
+
+### Making Changes
+
+⚠️ **Important**: All code modifications should be made in the `fleet/_async/` directory. The synchronous versions in `fleet/` are automatically generated.
+
+1. Make your changes in `fleet/_async/`
+2. Run `make unasync` to generate the sync versions
+3. Test both async and sync versions
+4. Commit all changes (both async source and generated sync files)
+
+Example workflow:
+```bash
+# Edit the async source files
+vim fleet/_async/client.py
+
+# Generate sync versions
+make unasync
+
+# Run tests
+python examples/examle.py
+
+# Commit both source and generated files
+git add fleet/_async/ fleet/
+git commit -m "Add new feature"
+```
+
+### Why This Structure?
+
+- Single source of truth for business logic
+- Automatic sync/async API generation
+- Consistent behavior between sync and async versions
+- Easier maintenance and testing

fleet_python-0.2.7/README.md

@@ -0,0 +1,117 @@
+# Fleet SDK
+
+The Fleet Python SDK provides programmatic access to Fleet's environment infrastructure.
+
+## Installation
+
+Install the Fleet SDK using pip:
+
+```bash
+pip install fleet-python
+```
+
+## API Key Setup
+
+Fleet requires an API key for authentication. You can obtain one from the [Fleet Platform](https://fleetai.com/dashboard/api-keys).
+
+Set your API key as an environment variable:
+
+```bash
+export FLEET_API_KEY="sk_your_key_here"
+```
+
+## Basic Usage
+
+```python
+import fleet as flt
+
+# Create environment by key
+env = flt.env.make("fira")
+
+# Reset environment with seed and options
+env.reset(
+    seed=42,
+    timestamp=datetime.now()
+)
+
+# Access environment state ('crm' is the resource id for a sqlite database)
+sql = env.state("sqlite://crm")
+sql.exec("UPDATE customers SET status = 'active' WHERE id = 123")
+
+# Clean up
+env.close()
+```
+
+## Environment Management
+
+### Creating Instances
+
+```python
+# Create environment instance with explicit version
+env = flt.env.make("fira:v1.2.5")
+
+# Create environment instance with default (latest) version
+env = flt.env.make("fira")
+
+```
+
+### Connecting to Existing Instances
+
+```python
+# Connect to a running instance
+env = flt.env.get("env_instance_id")
+
+# List all running instances
+instances = flt.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 = flt.env.list_instances(status_filter="running")
+
+# List available environment types
+available_envs = flt.env.list_envs()
+```
+
+## Development
+
+### Code Structure
+
+This SDK uses `unasync` to maintain both async and sync versions of the code from a single source:
+
+- **`fleet/_async/`** - The source code (async version) - **EDIT THIS**
+- **`fleet/`** - The generated sync version - **DO NOT EDIT** (auto-generated)
+
+### Making Changes
+
+⚠️ **Important**: All code modifications should be made in the `fleet/_async/` directory. The synchronous versions in `fleet/` are automatically generated.
+
+1. Make your changes in `fleet/_async/`
+2. Run `make unasync` to generate the sync versions
+3. Test both async and sync versions
+4. Commit all changes (both async source and generated sync files)
+
+Example workflow:
+```bash
+# Edit the async source files
+vim fleet/_async/client.py
+
+# Generate sync versions
+make unasync
+
+# Run tests
+python examples/examle.py
+
+# Commit both source and generated files
+git add fleet/_async/ fleet/
+git commit -m "Add new feature"
+```
+
+### Why This Structure?
+
+- Single source of truth for business logic
+- Automatic sync/async API generation
+- Consistent behavior between sync and async versions
+- Easier maintenance and testing

{fleet_python-0.2.4 → fleet_python-0.2.7}/examples/dsl_example.py

@@ -1,6 +1,9 @@
 import asyncio
 import fleet as flt
 from fleet.verifiers import DatabaseSnapshot, IgnoreConfig, TASK_SUCCESSFUL_SCORE
+from dotenv import load_dotenv
+
+load_dotenv()
 
 
 def validate_new_deal_creation(

{fleet_python-0.2.4 → fleet_python-0.2.7}/examples/example.py

@@ -3,6 +3,9 @@
 
 import asyncio
 import fleet as flt
+from dotenv import load_dotenv
+
+load_dotenv()
 
 
 async def main():
@@ -11,7 +14,7 @@ async def main():
 
     # Create a new instance
     env = await flt.env.make_async("hubspot:v1.2.7")
-    print("New Instance:", env.instance_id)
+    print(f"New Instance: {env.instance_id} ({env.region})")
 
     response = await env.reset(seed=42)
     print("Reset response:", response)

fleet_python-0.2.7/examples/example_client.py

@@ -0,0 +1,43 @@
+#!/usr/bin/env python3
+"""Example demonstrating browser control with Fleet Manager Client."""
+
+import asyncio
+import fleet as flt
+from dotenv import load_dotenv
+
+load_dotenv()
+
+
+async def main():
+    fleet = flt.AsyncFleet()
+
+    environments = await fleet.list_envs()
+    print("Environments:", len(environments))
+
+    # Create a new instance
+    env = await fleet.make("fira")
+    print(f"New Instance: {env.instance_id} ({env.region})")
+
+    response = await env.reset(seed=42)
+    print("Reset response:", response)
+
+    print(await env.resources())
+
+    sqlite = env.db()
+    print("SQLite:", await sqlite.describe())
+
+    print("Query:", await sqlite.query("SELECT * FROM users"))
+
+    sqlite = await env.state("sqlite://current").describe()
+    print("SQLite:", sqlite)
+
+    browser = env.browser()
+    print("CDP URL:", await browser.cdp_url())
+    print("Devtools URL:", await browser.devtools_url())
+
+    # Delete the instance
+    await fleet.delete(env.instance_id)
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

fleet_python-0.2.7/examples/example_sync.py

@@ -0,0 +1,40 @@
+#!/usr/bin/env python3
+"""Example demonstrating browser control with Fleet Manager Client."""
+
+import fleet as flt
+from dotenv import load_dotenv
+
+load_dotenv()
+
+
+def main():
+    environments = flt.env.list_envs()
+    print("Environments:", len(environments))
+
+    # Create a new instance
+    env = flt.env.make("hubspot:v1.2.7")
+    print("New Instance:", env.instance_id)
+
+    response = env.reset(seed=42)
+    print("Reset response:", response)
+
+    print(env.resources())
+
+    sqlite = env.db()
+    print("SQLite:", sqlite.describe())
+
+    print("Query:", sqlite.query("SELECT * FROM users"))
+
+    sqlite = env.state("sqlite://current").describe()
+    print("SQLite:", sqlite)
+
+    browser = env.browser()
+    print("CDP URL:", browser.cdp_url())
+    print("Devtools URL:", browser.devtools_url())
+
+    # Delete the instance
+    env.close()
+
+
+if __name__ == "__main__":
+    main()

{fleet_python-0.2.4 → fleet_python-0.2.7}/examples/json_tasks_example.py

@@ -6,6 +6,9 @@ from typing import TypedDict, List
 from pathlib import Path
 import fleet as flt
 from nova_act import NovaAct, ActResult
+from dotenv import load_dotenv
+
+load_dotenv()
 
 
 MAX_STEPS = 30

{fleet_python-0.2.4 → fleet_python-0.2.7}/examples/nova_act_example.py

@@ -1,6 +1,9 @@
 import asyncio
 import fleet as flt
 from nova_act import NovaAct, ActResult
+from dotenv import load_dotenv
+
+load_dotenv()
 
 
 async def main():

{fleet_python-0.2.4 → fleet_python-0.2.7}/examples/openai_example.py

@@ -2,6 +2,9 @@ from openai import OpenAI
 import fleet as flt
 import json
 from typing import Callable
+from dotenv import load_dotenv
+
+load_dotenv()
 
 
 client = OpenAI()

{fleet_python-0.2.4 → fleet_python-0.2.7}/examples/openai_simple_example.py

@@ -1,5 +1,8 @@
 from openai import OpenAI
 import fleet as flt
+from dotenv import load_dotenv
+
+load_dotenv()
 
 client = OpenAI()
 

{fleet_python-0.2.4 → fleet_python-0.2.7}/examples/quickstart.py

@@ -7,9 +7,11 @@ This example demonstrates basic usage of the Fleet SDK for environment managemen
 
 import asyncio
 import logging
-from typing import Dict, Any
+from dotenv import load_dotenv
 
-import fleet
+load_dotenv()
+
+from fleet import AsyncFleet
 
 
 # Configure logging
@@ -19,23 +21,14 @@ logger = logging.getLogger(__name__)
 
 async def main():
     """Main example function."""
-    
-    # Check API health
-    print("🔍 Checking Fleet API health...")
-    try:
-        config = fleet.get_config()
-        client = fleet.FleetAPIClient(config)
-        health = await client.health_check()
-        print(f"✅ API Status: {health.status}")
-        await client.close()
-    except Exception as e:
-        print(f"❌ API Health Check failed: {e}")
-        return
-    
+
+    # Initialize the Fleet client
+    fleet_client = AsyncFleet()
+
     # 1. List available environments
     print("\n📋 Available environments:")
     try:
-        environments = await fleet.instance.list_envs()
+        environments = await fleet_client.list_envs()
         for env in environments:
             print(f"  - {env.env_key}: {env.name}")
             print(f"    Description: {env.description}")
@@ -44,77 +37,66 @@ async def main():
     except Exception as e:
         print(f"❌ Failed to list environments: {e}")
         return
-    
+
     # 2. Create a new environment instance
     print("\n🚀 Creating new environment...")
     try:
-        env = await fleet.instance.make("fira:v1.2.5", region="us-west-1")
+        env = await fleet_client.make("fira:v1.3.1")
         print(f"✅ Environment created with instance ID: {env.instance_id}")
-        
-        # Execute a simple action
+
+        # TODO: Execute a simple action
         print("\n⚡ Executing a simple action...")
         action = {"type": "test", "data": {"message": "Hello Fleet!"}}
-        state, reward, done = await env.step(action)
+        state, reward, done = await env.instance.step(action)
         print(f"✅ Action executed successfully!")
         print(f"   Reward: {reward}")
         print(f"   Done: {done}")
         print(f"   State keys: {list(state.keys())}")
-        
-        # Check manager API health
-        print("\n🏥 Checking manager API health...")
-        try:
-            manager_health = await env.manager_health_check()
-            if manager_health:
-                print(f"✅ Manager API Status: {manager_health.status}")
-                print(f"   Service: {manager_health.service}")
-                print(f"   Timestamp: {manager_health.timestamp}")
-            else:
-                print("❌ Manager API not available")
-        except Exception as e:
-            print(f"❌ Manager health check failed: {e}")
-        
+
         # Clean up
         print("\n🧹 Cleaning up...")
         await env.close()
         print("✅ Environment closed")
-        
+
     except Exception as e:
         print(f"❌ Environment creation failed: {e}")
         return
-    
+
     # 3. List running instances
     print("\n🏃 Listing running instances...")
     try:
-        instances = await fleet.instance.list_instances(status="running")
+        instances = await fleet_client.instances(status="running")
         if instances:
             print(f"Found {len(instances)} running instances:")
             for instance in instances:
-                print(f"  - {instance.instance_id}: {instance.env_key} ({instance.status})")
+                print(
+                    f"  - {instance.instance_id}: {instance.env_key} ({instance.status})"
+                )
         else:
             print("No running instances found")
     except Exception as e:
         print(f"❌ Failed to list instances: {e}")
-    
+
     # 4. Connect to an existing instance (if any)
     print("\n🔗 Connecting to existing instance...")
     try:
         # Only get running instances
-        running_instances = await fleet.instance.list_instances(status="running")
+        running_instances = await fleet_client.instances(status="running")
         if running_instances:
             # Find a running instance that's not the one we just created/deleted
             target_instance = running_instances[0]
             print(f"Connecting to running instance: {target_instance.instance_id}")
-            
-            env = await fleet.instance.get(target_instance.instance_id)
+
+            env = await fleet_client.instance(target_instance.instance_id)
             print(f"✅ Connected to instance: {env.instance_id}")
-            
+
             # Execute an action on the existing instance
             action = {"type": "ping", "data": {"timestamp": "2024-01-01T00:00:00Z"}}
-            state, reward, done = await env.step(action)
+            state, reward, done = await env.instance.step(action)
             print(f"✅ Action executed on existing instance!")
             print(f"   Reward: {reward}")
             print(f"   Done: {done}")
-            
+
             # Clean up (this will delete the instance)
             await env.close()
             print("✅ Connection closed (instance deleted)")
@@ -122,9 +104,9 @@ async def main():
             print("No running instances to connect to")
     except Exception as e:
         print(f"❌ Failed to connect to existing instance: {e}")
-    
+
     print("\n🎉 Quickstart complete!")
 
 
 if __name__ == "__main__":
-    asyncio.run(main()) 
+    asyncio.run(main())

{fleet_python-0.2.4 → fleet_python-0.2.7}/fleet/__init__.py

@@ -25,7 +25,6 @@ from ._async.client import AsyncFleet, AsyncEnvironment
 from .models import InstanceRequest
 from .instance import (
     InstanceClient,
-    AsyncInstanceClient,
     ResetRequest,
     ResetResponse,
     CDPDescribeResponse,
@@ -33,6 +32,7 @@ from .instance import (
     ChromeStartResponse,
     ChromeStatusResponse,
 )
+from ._async.instance import AsyncInstanceClient
 from .verifiers import (
     DatabaseSnapshot,
     IgnoreConfig,

fleet_python-0.2.7/fleet/_async/__init__.py

@@ -0,0 +1 @@
+# This file makes the _async directory a proper Python package

{fleet_python-0.2.4 → fleet_python-0.2.7}/fleet/_async/client.py

@@ -126,8 +126,12 @@ class AsyncFleet:
 
     async def instance(self, instance_id: str) -> AsyncEnvironment:
         response = await self.client.request("GET", f"/v1/env/instances/{instance_id}")
-        return AsyncEnvironment(**response.json())
+        instance = AsyncEnvironment(**response.json())
+        await instance.instance.load()
+        return instance
 
     async def delete(self, instance_id: str) -> InstanceRecord:
-        response = await self.client.request("DELETE", f"/v1/env/instances/{instance_id}")
-        return InstanceRecord(**response.json())
+        response = await self.client.request(
+            "DELETE", f"/v1/env/instances/{instance_id}"
+        )
+        return InstanceRecord(**response.json())

{fleet_python-0.2.4 → fleet_python-0.2.7}/fleet/_async/env/client.py

@@ -1,6 +1,6 @@
 from ..client import AsyncFleet, AsyncEnvironment
 from ..models import Environment as EnvironmentModel
-from typing import List
+from typing import List, Optional
 
 
 async def make_async(env_key: str) -> AsyncEnvironment:
@@ -11,5 +11,9 @@ async def list_envs_async() -> List[EnvironmentModel]:
     return await AsyncFleet().list_envs()
 
 
+async def list_instances_async(status: Optional[str] = None) -> List[AsyncEnvironment]:
+    return await AsyncFleet().instances(status=status)
+
+
 async def get_async(instance_id: str) -> AsyncEnvironment:
-    return await AsyncFleet().instance(instance_id)
+    return await AsyncFleet().instance(instance_id)