Installation
- Python 3.10 or later
- pip 20.0+
Basic Execution
1
Create a file hello.py
2
Run it
- BoxLite pulls the
python:slimOCI image (first run only) - Creates a lightweight VM with the image
- Executes the Python command inside the VM
- Streams output back to your application
- Automatically cleans up when the context exits
Code Execution (AI Agents)
1
Create a file codebox.py
2
Run it
- CodeBox automatically installs required packages (requests)
- Executes the code in complete isolation
- Returns the output
- Your host system remains completely safe
Running Examples
BoxLite includes 9 comprehensive Python examples:Next Steps
Core concepts
Understand the different box types (SimpleBox, CodeBox, BrowserBox, and more), lifecycle, images, and resource configuration.
Execute AI-generated code
Learn to use CodeBox for safe code execution — auto-install packages, run untrusted code, and capture output.
Python SDK Reference
Complete API reference for SimpleBox, CodeBox, BrowserBox, ComputerBox, and more.

