​

What You’ll Learn

• Install and verify the Python SDK
• Set up API key authentication
• Create a sandbox from a template
• Execute Python code in the sandbox
• Access execution results and output
• Clean up sandboxes properly

​

Step 1: Install the SDK

pip install hopx-ai

​

Step 1.5: Verify Installation

python -c "import hopx_ai; print(f'HopX SDK {hopx_ai.__version__} installed successfully')"

​

Step 2: Set Your API key

# Linux/macOS
export HOPX_API_KEY="your-api-key-here"

# Windows (PowerShell)
$env:HOPX_API_KEY="your-api-key-here"

​

Step 3: Create and Run Your First Sandbox

from hopx_ai import Sandbox

# Create a sandbox (~100ms)
sandbox = Sandbox.create(template="code-interpreter")

# Execute code in the sandbox
result = sandbox.run_code('print("Hello from HopX!")')

# Print the output
print(result.stdout)

Hello from HopX!

​

Cleanup - delete the sandbox

## Step 4: Run It

```bash
python hello_hopx.py

​

Expected Output

Hello from HopX!

​

What Just Happened?

1. Sandbox.create() - Created a new sandbox from the code-interpreter template (Python environment)
2. sandbox.run_code() - Executed Python code in the sandbox
3. result.stdout - Retrieved the standard output from code execution
4. sandbox.kill() - Deleted the sandbox to free resources

​

Related

• API Quickstart - Get started with the API
• Sandbox Class Reference - Complete SDK reference
• Creating Sandboxes - Learn more about sandbox creation
• Code Execution - Understand code execution

​

Next Steps

• Creating Sandboxes - Learn about different templates and options
• Code Execution - Run Python, JavaScript, Bash, and more
• File Operations - Read, write, and manage files in sandboxes
• CLI Quickstart - Use HopX from the command line
• API Reference - Complete SDK documentation

​

Quickstart Variations

​

Troubleshooting

• Verify HOPX_API_KEY is set: echo $HOPX_API_KEY
• Get your key at console.hopx.dev

• Use template="code-interpreter" (default Python template)
• See Available Templates for options

• Check internet connection
• Verify firewall allows HTTPS (port 443)