python-executor
101-skills/superpowers
Execute Python code in a sandboxed environment with 100+ pre-installed libraries.
What is python-executor?
Run Python scripts safely in an isolated sandbox via inference.sh with NumPy, Pandas, Matplotlib, Selenium, OpenCV, and 100+ other libraries pre-installed. Use for data processing, web scraping, image manipulation, video creation, 3D modeling, and automation tasks.
- Execute arbitrary Python code in CPU-only sandboxed environment
- Access 100+ pre-installed libraries including data science, web scraping, image/video, and 3D processing tools
- Save output files (images, CSVs, videos, 3D models) that are automatically returned
- Support configurable timeout (1-300 seconds) and memory variants (8GB default or 16GB high_memory)
- Capture stdout/stderr output from Python execution
- Run non-interactive scripts with automatic file detection
How to install python-executor
npx skills add https://github.com/101-skills/superpowers --skill python-executor- Install inference.sh CLI (belt): npx skills add belt-sh/cli
- Run belt login to authenticate
- Requires network access for web scraping and API calls
How to use python-executor
- 1.Install the belt CLI skill with npx skills add belt-sh/cli
- 2.Authenticate with belt login
- 3.Call the skill with belt app run infsh/python-executor --input with JSON containing code, optional timeout, and capture_output flag
- 4.Write Python code that saves outputs to outputs/ directory (e.g., plt.savefig('outputs/chart.png'))
- 5.Retrieve returned files and stdout from the response
Use cases
- Web scraping with BeautifulSoup and Selenium to extract structured data from websites
- Data analysis and visualization: load CSV/JSON, process with Pandas, plot with Matplotlib
- Image processing: resize, crop, composite, or generate images with Pillow and OpenCV
- Video creation: generate videos with text overlays and effects using MoviePy
- 3D model processing: load, transform, and export STL/OBJ files with trimesh
- Data analysts and scientists processing datasets
- Web developers and automation engineers building scrapers
- Content creators generating images, videos, or 3D models programmatically
- Backend developers integrating external APIs or building automation scripts
- Researchers prototyping data pipelines and visualizations
python-executor FAQ
Python 3.10 with 100+ pre-installed libraries including NumPy, Pandas, Matplotlib, requests, BeautifulSoup, Selenium, Playwright, MoviePy, Pillow, OpenCV, trimesh, and more. See the SKILL.md for the complete list organized by category.
No, this is CPU-only. For GPU-accelerated ML tasks, use dedicated AI apps like ai-image-generation or ai-video-generation skills.
Save files to the outputs/ directory (e.g., plt.savefig('outputs/chart.png') or mesh.export('outputs/model.stl')) and they will be automatically detected and returned in the response.
Timeout is configurable from 1-300 seconds with a default of 30 seconds. For long-running tasks like video generation, increase the timeout parameter.
Yes, code runs in an isolated subprocess within a sandboxed environment with no access to the host system or other executions.
Full instructions (SKILL.md)
Source of truth, from 101-skills/superpowers.
name: python-executor description: "Execute Python code in a safe sandboxed environment via inference.sh. Pre-installed: NumPy, Pandas, Matplotlib, requests, BeautifulSoup, Selenium, Playwright, MoviePy, Pillow, OpenCV, trimesh, and 100+ more libraries. Use for: data processing, web scraping, image manipulation, video creation, 3D model processing, PDF generation, API calls, automation scripts. Triggers: python, execute code, run script, web scraping, data analysis, image processing, video editing, 3D models, automation, pandas, matplotlib" allowed-tools: Bash(belt *)
Install the belt CLI skill:
npx skills add belt-sh/cli
Python Code Executor
Execute Python code in a safe, sandboxed environment with 100+ pre-installed libraries.

Quick Start
Requires inference.sh CLI (
belt). Install instructions
belt login
# Run Python code
belt app run infsh/python-executor --input '{
"code": "import pandas as pd\nprint(pd.__version__)"
}'
App Details
| Property | Value |
|---|---|
| App ID | infsh/python-executor |
| Environment | Python 3.10, CPU-only |
| RAM | 8GB (default) / 16GB (high_memory) |
| Timeout | 1-300 seconds (default: 30) |
Input Schema
{
"code": "print('Hello World!')",
"timeout": 30,
"capture_output": true,
"working_dir": null
}
Pre-installed Libraries
Web Scraping & HTTP
requests,httpx,aiohttp- HTTP clientsbeautifulsoup4,lxml- HTML/XML parsingselenium,playwright- Browser automationscrapy- Web scraping framework
Data Processing
numpy,pandas,scipy- Numerical computingmatplotlib,seaborn,plotly- Visualization
Image Processing
pillow,opencv-python-headless- Image manipulationscikit-image,imageio- Image algorithms
Video & Audio
moviepy- Video editingav(PyAV),ffmpeg-python- Video processingpydub- Audio manipulation
3D Processing
trimesh,open3d- 3D mesh processingnumpy-stl,meshio,pyvista- 3D file formats
Documents & Graphics
svgwrite,cairosvg- SVG creationreportlab,pypdf2- PDF generation
Examples
Web Scraping
belt app run infsh/python-executor --input '{
"code": "import requests\nfrom bs4 import BeautifulSoup\n\nresponse = requests.get(\"https://example.com\")\nsoup = BeautifulSoup(response.content, \"html.parser\")\nprint(soup.find(\"title\").text)"
}'
Data Analysis with Visualization
belt app run infsh/python-executor --input '{
"code": "import pandas as pd\nimport matplotlib.pyplot as plt\n\ndata = {\"name\": [\"Alice\", \"Bob\"], \"sales\": [100, 150]}\ndf = pd.DataFrame(data)\n\nplt.bar(df[\"name\"], df[\"sales\"])\nplt.savefig(\"outputs/chart.png\")\nprint(\"Chart saved!\")"
}'
Image Processing
belt app run infsh/python-executor --input '{
"code": "from PIL import Image\nimport numpy as np\n\n# Create gradient image\narr = np.linspace(0, 255, 256*256, dtype=np.uint8).reshape(256, 256)\nimg = Image.fromarray(arr, mode=\"L\")\nimg.save(\"outputs/gradient.png\")\nprint(\"Image created!\")"
}'
Video Creation
belt app run infsh/python-executor --input '{
"code": "from moviepy.editor import ColorClip, TextClip, CompositeVideoClip\n\nclip = ColorClip(size=(640, 480), color=(0, 100, 200), duration=3)\ntxt = TextClip(\"Hello!\", fontsize=70, color=\"white\").set_position(\"center\").set_duration(3)\nvideo = CompositeVideoClip([clip, txt])\nvideo.write_videofile(\"outputs/hello.mp4\", fps=24)\nprint(\"Video created!\")",
"timeout": 120
}'
3D Model Processing
belt app run infsh/python-executor --input '{
"code": "import trimesh\n\nsphere = trimesh.creation.icosphere(subdivisions=3, radius=1.0)\nsphere.export(\"outputs/sphere.stl\")\nprint(f\"Created sphere with {len(sphere.vertices)} vertices\")"
}'
API Calls
belt app run infsh/python-executor --input '{
"code": "import requests\nimport json\n\nresponse = requests.get(\"https://api.github.com/users/octocat\")\ndata = response.json()\nprint(json.dumps(data, indent=2))"
}'
File Output
Files saved to outputs/ are automatically returned:
# These files will be in the response
plt.savefig('outputs/chart.png')
df.to_csv('outputs/data.csv')
video.write_videofile('outputs/video.mp4')
mesh.export('outputs/model.stl')
Variants
# Default (8GB RAM)
belt app run infsh/python-executor --input input.json
# High memory (16GB RAM) for large datasets
belt app run infsh/python-executor@high_memory --input input.json
Use Cases
- Web scraping - Extract data from websites
- Data analysis - Process and visualize datasets
- Image manipulation - Resize, crop, composite images
- Video creation - Generate videos with text overlays
- 3D processing - Load, transform, export 3D models
- API integration - Call external APIs
- PDF generation - Create reports and documents
- Automation - Run any Python script
Important Notes
- CPU-only - No GPU/ML libraries (use dedicated AI apps for that)
- Safe execution - Runs in isolated subprocess
- Non-interactive - Use
plt.savefig()notplt.show() - File detection - Output files are auto-detected and returned
Related Skills
# AI image generation (for ML-based images)
npx skills add inference-sh/skills@ai-image-generation
# AI video generation (for ML-based videos)
npx skills add inference-sh/skills@ai-video-generation
# LLM models (for text generation)
npx skills add inference-sh/skills@llm-models
Documentation
- Running Apps - How to run apps via CLI
- App Code - Understanding app execution
- Sandboxed Code Execution - Safe code execution for agents
Related skills
More from 101-skills/superpowers and the wider catalog.

seedance
Generate AI videos with synchronized audio using ByteDance Seedance 2.0 via inference.sh CLI.

storyboard-creation
Create visual storyboards with AI image generation, shot vocabulary, and continuity rules for film and video planning.

twitter-automation
Automate Twitter/X posting, engagement, and user management via inference.sh CLI.

video-ad-specs
Platform-specific video ad specs and creation templates for TikTok, Instagram, YouTube, Facebook, and LinkedIn.

web-search
Web search and content extraction via Tavily and Exa APIs through inference.sh CLI.

youtube-thumbnail-design
Design high-CTR YouTube thumbnails with AI image generation, safe zones, and psychology-backed composition rules.