buildfunctions 0.2.0__tar.gz → 0.2.1__tar.gz

buildfunctions-0.2.1/.env.example

@@ -0,0 +1,2 @@
+# Get an API token at https://www.buildfunctions.com/settings
+BUILDFUNCTIONS_API_TOKEN=""

buildfunctions-0.2.1/.gitignore

@@ -0,0 +1,18 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+.eggs/
+*.egg
+.env*
+!.env.example
+!.env.*.example
+.venv/
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+*.log
+.DS_Store
+.claude*
+.pytest_cache*

buildfunctions-0.2.1/MANIFEST.in

@@ -0,0 +1,5 @@
+include README.md
+include src/buildfunctions/py.typed
+recursive-exclude tests *
+exclude .env*
+exclude .git*

buildfunctions-0.2.1/PKG-INFO

@@ -0,0 +1,176 @@
+Metadata-Version: 2.4
+Name: buildfunctions
+Version: 0.2.1
+Summary: The Buildfunctions SDK for Agents: Hardware-isolated CPU and GPU Sandboxes for untrusted AI actions
+Project-URL: Homepage, https://www.buildfunctions.com
+Project-URL: Documentation, https://www.buildfunctions.com/docs/sdk/quickstart
+Project-URL: Repository, https://github.com/buildfunctions/sdk-python
+Project-URL: Issues, https://github.com/buildfunctions/sdk-python/issues
+Author: Buildfunctions
+Keywords: AIAgents,AIApps,AIInfrastructure,DeveloperExperience,GPUs,Sandboxes,Serverless
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27
+Requires-Dist: python-dotenv>=1.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.13; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.8; extra == 'dev'
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <h1 align="center">
+  <a href="https://www.buildfunctions.com" target="_blank">
+    <img src="./static/readme/buildfunctions-header.svg" alt="logo" width="900">
+  </a>
+  </h1>
+</p>
+
+<h1 align="center">The Buildfunctions SDK for Agents</h1>
+
+<p align="center">
+  <!-- <a href="https://discord.com/users/buildfunctions" target="_blank">
+    <img src="./static/readme/discord-button.png" height="32" />
+  </a>&nbsp; -->
+  <a href="https://www.buildfunctions.com/docs/sdk/quickstart" target="_blank">
+    <img src="./static/readme/read-the-docs-button.png" height="32" />
+  </a>&nbsp;
+</p>
+
+<p align="center">
+<a href="https://pypi.org/project/buildfunctions" target="_blank">
+  <img src="https://img.shields.io/badge/pypi-buildfunctions-green">
+</a>
+</p>
+
+<p align="center">
+  <h1 align="center">
+  <a href="https://www.buildfunctions.com" target="_blank">
+    <img src="./static/readme/buildfunctions-logo-and-servers-dark.svg" alt="logo" width="900">
+  </a>
+  </h1>
+</p>
+
+> Hardware-isolated execution environments for AI agents
+
+## Installation
+
+```bash
+pip install buildfunctions
+```
+
+## Quick Start
+
+### 1. Create an API Token
+
+Get your API token at [buildfunctions.com/settings](https://www.buildfunctions.com/settings)
+
+### 2. CPU Function
+
+```python
+import asyncio
+import os
+from buildfunctions import Buildfunctions, CPUFunction
+
+async def main():
+    client = await Buildfunctions({"apiToken": os.environ["BUILDFUNCTIONS_API_TOKEN"]})
+
+    deployed_function = await CPUFunction.create({
+        "name": "my-cpu-function",
+        "code": "./cpu_function_code.py",
+        "language": "python",
+        "memory": 128,
+        "timeout": 30,
+    })
+
+    print(f"Endpoint: {deployed_function.endpoint}")
+
+    await deployed_function.delete()
+
+asyncio.run(main())
+```
+
+### 3. CPU Sandbox
+
+```python
+import asyncio
+import os
+from buildfunctions import Buildfunctions, CPUSandbox
+
+async def main():
+    client = await Buildfunctions({"apiToken": os.environ["BUILDFUNCTIONS_API_TOKEN"]})
+
+    sandbox = await CPUSandbox.create({
+        "name": "my-cpu-sandbox",
+        "language": "python",
+        "code": "/path/to/code/cpu_sandbox_code.py",
+        "memory": 128,
+        "timeout": 30,
+    })
+
+    result = await sandbox.run()
+    print(f"Result: {result}")
+
+    await sandbox.delete()
+
+asyncio.run(main())
+```
+
+### 4. GPU Function
+
+```python
+import asyncio
+import os
+from buildfunctions import Buildfunctions, GPUFunction
+
+async def main():
+    client = await Buildfunctions({"apiToken": os.environ["BUILDFUNCTIONS_API_TOKEN"]})
+
+    deployed_function = await GPUFunction.create({
+        "name": "my-gpu-function",
+        "code": "/path/to/code/gpu_function_code.py",
+        "language": "python",
+        "gpu": "T4",
+        "vcpus": 30,
+        "memory": "50000MB",
+        "timeout": 300,
+        "requirements": ["transformers==4.47.1", "torch", "accelerate"],
+    })
+
+    print(f"Endpoint: {deployed_function.endpoint}")
+
+    await deployed_function.delete()
+
+asyncio.run(main())
+```
+
+### 5. GPU Sandbox with Local Model
+
+```python
+import asyncio
+import os
+from buildfunctions import Buildfunctions, GPUSandbox
+
+async def main():
+    client = await Buildfunctions({"apiToken": os.environ["BUILDFUNCTIONS_API_TOKEN"]})
+
+    sandbox = await GPUSandbox.create({
+        "name": "my-gpu-sandbox",
+        "language": "python",
+        "memory": 10000,
+        "timeout": 300,
+        "vcpus": 6,
+        "code": "./gpu_sandbox_code.py",
+        "model": "/path/to/models/Qwen/Qwen3-8B",
+        "requirements": "torch",
+    })
+
+    result = await sandbox.run()
+    print(f"Response: {result}")
+
+    await sandbox.delete()
+
+asyncio.run(main())
+```
+
+The SDK is currently in beta.

buildfunctions-0.2.1/README.md

@@ -0,0 +1,156 @@
+<p align="center">
+  <h1 align="center">
+  <a href="https://www.buildfunctions.com" target="_blank">
+    <img src="./static/readme/buildfunctions-header.svg" alt="logo" width="900">
+  </a>
+  </h1>
+</p>
+
+<h1 align="center">The Buildfunctions SDK for Agents</h1>
+
+<p align="center">
+  <!-- <a href="https://discord.com/users/buildfunctions" target="_blank">
+    <img src="./static/readme/discord-button.png" height="32" />
+  </a>&nbsp; -->
+  <a href="https://www.buildfunctions.com/docs/sdk/quickstart" target="_blank">
+    <img src="./static/readme/read-the-docs-button.png" height="32" />
+  </a>&nbsp;
+</p>
+
+<p align="center">
+<a href="https://pypi.org/project/buildfunctions" target="_blank">
+  <img src="https://img.shields.io/badge/pypi-buildfunctions-green">
+</a>
+</p>
+
+<p align="center">
+  <h1 align="center">
+  <a href="https://www.buildfunctions.com" target="_blank">
+    <img src="./static/readme/buildfunctions-logo-and-servers-dark.svg" alt="logo" width="900">
+  </a>
+  </h1>
+</p>
+
+> Hardware-isolated execution environments for AI agents
+
+## Installation
+
+```bash
+pip install buildfunctions
+```
+
+## Quick Start
+
+### 1. Create an API Token
+
+Get your API token at [buildfunctions.com/settings](https://www.buildfunctions.com/settings)
+
+### 2. CPU Function
+
+```python
+import asyncio
+import os
+from buildfunctions import Buildfunctions, CPUFunction
+
+async def main():
+    client = await Buildfunctions({"apiToken": os.environ["BUILDFUNCTIONS_API_TOKEN"]})
+
+    deployed_function = await CPUFunction.create({
+        "name": "my-cpu-function",
+        "code": "./cpu_function_code.py",
+        "language": "python",
+        "memory": 128,
+        "timeout": 30,
+    })
+
+    print(f"Endpoint: {deployed_function.endpoint}")
+
+    await deployed_function.delete()
+
+asyncio.run(main())
+```
+
+### 3. CPU Sandbox
+
+```python
+import asyncio
+import os
+from buildfunctions import Buildfunctions, CPUSandbox
+
+async def main():
+    client = await Buildfunctions({"apiToken": os.environ["BUILDFUNCTIONS_API_TOKEN"]})
+
+    sandbox = await CPUSandbox.create({
+        "name": "my-cpu-sandbox",
+        "language": "python",
+        "code": "/path/to/code/cpu_sandbox_code.py",
+        "memory": 128,
+        "timeout": 30,
+    })
+
+    result = await sandbox.run()
+    print(f"Result: {result}")
+
+    await sandbox.delete()
+
+asyncio.run(main())
+```
+
+### 4. GPU Function
+
+```python
+import asyncio
+import os
+from buildfunctions import Buildfunctions, GPUFunction
+
+async def main():
+    client = await Buildfunctions({"apiToken": os.environ["BUILDFUNCTIONS_API_TOKEN"]})
+
+    deployed_function = await GPUFunction.create({
+        "name": "my-gpu-function",
+        "code": "/path/to/code/gpu_function_code.py",
+        "language": "python",
+        "gpu": "T4",
+        "vcpus": 30,
+        "memory": "50000MB",
+        "timeout": 300,
+        "requirements": ["transformers==4.47.1", "torch", "accelerate"],
+    })
+
+    print(f"Endpoint: {deployed_function.endpoint}")
+
+    await deployed_function.delete()
+
+asyncio.run(main())
+```
+
+### 5. GPU Sandbox with Local Model
+
+```python
+import asyncio
+import os
+from buildfunctions import Buildfunctions, GPUSandbox
+
+async def main():
+    client = await Buildfunctions({"apiToken": os.environ["BUILDFUNCTIONS_API_TOKEN"]})
+
+    sandbox = await GPUSandbox.create({
+        "name": "my-gpu-sandbox",
+        "language": "python",
+        "memory": 10000,
+        "timeout": 300,
+        "vcpus": 6,
+        "code": "./gpu_sandbox_code.py",
+        "model": "/path/to/models/Qwen/Qwen3-8B",
+        "requirements": "torch",
+    })
+
+    result = await sandbox.run()
+    print(f"Response: {result}")
+
+    await sandbox.delete()
+
+asyncio.run(main())
+```
+
+The SDK is currently in beta.

buildfunctions-0.2.1/pyproject.toml

@@ -0,0 +1,50 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "buildfunctions"
+version = "0.2.1"
+description = "The Buildfunctions SDK for Agents: Hardware-isolated CPU and GPU Sandboxes for untrusted AI actions"
+readme = "README.md"
+requires-python = ">=3.10"
+authors = [
+    { name = "Buildfunctions" }
+]
+keywords = [
+    "AIAgents",
+    "AIInfrastructure",
+    "AIApps",
+    "Serverless",
+    "GPUs",
+    "Sandboxes",
+    "DeveloperExperience",
+]
+dependencies = [
+    "httpx>=0.27",
+    "python-dotenv>=1.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+    "pytest-asyncio>=0.24",
+    "mypy>=1.13",
+    "ruff>=0.8",
+]
+
+[project.urls]
+Homepage = "https://www.buildfunctions.com"
+Documentation = "https://www.buildfunctions.com/docs/sdk/quickstart"
+Repository = "https://github.com/buildfunctions/sdk-python"
+Issues = "https://github.com/buildfunctions/sdk-python/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/buildfunctions"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+
+[tool.ruff]
+target-version = "py311"
+line-length = 120

buildfunctions-0.2.1/src/buildfunctions/__init__.py

@@ -0,0 +1,139 @@
+"""Buildfunctions SDK - Python SDK for the serverless platform for AI agents.
+
+Example:
+    import asyncio
+    from buildfunctions import Buildfunctions, CPUSandbox, GPUSandbox, GPUFunction
+
+    async def main():
+        # Initialize the client (authenticates with the API)
+        client = await Buildfunctions({
+            "apiToken": os.environ["BUILDFUNCTIONS_API_TOKEN"]
+        })
+
+        # Access authenticated user info (supports both dot and bracket notation)
+        print(client.user.username)
+        print(client.authenticatedAt)
+
+        # Create a CPU sandbox
+        sandbox = await CPUSandbox.create({
+            "name": "my-sandbox",
+            "language": "python",
+            "memory": "512MB",
+        })
+
+        # Run code
+        result = await sandbox.run()
+        print(result.response)
+
+        # Clean up
+        await sandbox.delete()
+
+    asyncio.run(main())
+"""
+
+# Client exports - match TypeScript SDK naming exactly
+from buildfunctions.client import (
+    Buildfunctions,
+    buildfunctions,
+    createClient,
+    create_client,
+    init,
+)
+
+# Function builders - match TypeScript SDK naming exactly
+from buildfunctions.cpu_function import CPUFunction, create_cpu_function
+from buildfunctions.gpu_function import GPUFunction, create_gpu_function
+
+# Sandbox factories - match TypeScript SDK naming exactly
+from buildfunctions.cpu_sandbox import CPUSandbox, create_cpu_sandbox
+from buildfunctions.gpu_sandbox import GPUSandbox, create_gpu_sandbox
+
+# Errors
+from buildfunctions.errors import (
+    AuthenticationError,
+    BuildfunctionsError,
+    CapacityError,
+    NotFoundError,
+    ValidationError,
+)
+
+# Types
+from buildfunctions.types import (
+    AuthenticatedUser,
+    AuthResponse,
+    BuildfunctionsConfig,
+    CPUFunctionOptions,
+    CPUSandboxConfig,
+    CPUSandboxInstance,
+    CreateFunctionOptions,
+    DeployedFunction,
+    ErrorCode,
+    FileMetadata,
+    FindUniqueOptions,
+    Framework,
+    FunctionConfig,
+    GPUFunctionOptions,
+    GPUSandboxConfig,
+    GPUSandboxInstance,
+    GPUType,
+    Language,
+    ListOptions,
+    Memory,
+    RunResult,
+    Runtime,
+    SandboxInstance,
+    UploadOptions,
+)
+
+__all__ = [
+    # Client (PascalCase - matches TypeScript)
+    "Buildfunctions",
+    "createClient",
+    "init",
+    # Client (snake_case aliases)
+    "buildfunctions",
+    "create_client",
+    # Function builders (PascalCase - matches TypeScript)
+    "CPUFunction",
+    "GPUFunction",
+    # Function builders (snake_case aliases)
+    "create_cpu_function",
+    "create_gpu_function",
+    # Sandbox factories (PascalCase - matches TypeScript)
+    "CPUSandbox",
+    "GPUSandbox",
+    # Sandbox factories (snake_case aliases)
+    "create_cpu_sandbox",
+    "create_gpu_sandbox",
+    # Errors
+    "BuildfunctionsError",
+    "AuthenticationError",
+    "NotFoundError",
+    "ValidationError",
+    "CapacityError",
+    # Types
+    "BuildfunctionsConfig",
+    "AuthenticatedUser",
+    "AuthResponse",
+    "Language",
+    "Runtime",
+    "GPUType",
+    "Framework",
+    "Memory",
+    "FunctionConfig",
+    "CPUFunctionOptions",
+    "GPUFunctionOptions",
+    "CreateFunctionOptions",
+    "DeployedFunction",
+    "CPUSandboxConfig",
+    "GPUSandboxConfig",
+    "RunResult",
+    "UploadOptions",
+    "SandboxInstance",
+    "CPUSandboxInstance",
+    "GPUSandboxInstance",
+    "FindUniqueOptions",
+    "ListOptions",
+    "ErrorCode",
+    "FileMetadata",
+]