python-heredoc-fallback
Use shell Python heredoc as fallback when code sandbox fails
- License 许可
- MIT
- 所属仓库
- HKUDS/AgentPilot
- 最近更新
- 2026-11-12
- Stars
- ★ 8.0k
- Forks
- 944
01 前言 Front Matter
- name
- python-heredoc-fallback
- description
- Use shell Python heredoc as fallback when code sandbox fails
02 资源文件 1
- 其他.skill_id37 B
03 SKILL.md 正文
Python Heredoc Fallback for Code Execution
When to Use
Use this pattern when execute_code_sandbox fails with e2b initialization errors, sandbox connection issues, or other execution environment problems. This is especially reliable for file generation tasks.
Core Pattern
Instead of execute_code_sandbox, run Python code directly in the shell using a heredoc:
python3 << 'EOF'
# Your Python code here
import sys
print("Python code executing in shell")
EOF
Key Syntax Rules
- Use single-quoted EOF (
<< 'EOF') to prevent shell variable expansion within the Python code - No indentation before EOF - the closing delimiter must be at the start of the line
- Install packages first if needed, before the Python heredoc block
Common Use Cases
1. Matplotlib Graph Generation
python3 << 'EOF'
import matplotlib.pyplot as plt
import pandas as pd
# Load data
data = pd.read_excel('input.xlsx')
# Create visualization
plt.figure(figsize=(10, 6))
plt.plot(data['x'], data['y'])
plt.xlabel('X Label')
plt.ylabel('Y Label')
plt.title('Graph Title')
plt.savefig('output_graph.png', dpi=300, bbox_inches='tight')
plt.close()
print("Graph saved successfully")
EOF
2. Python-docx Document Creation
pip install python-docx -q
python3 << 'EOF'
from docx import Document
from docx.shared import Inches, Pt
from docx.enum.text import WD_ALIGN_PARAGRAPH
doc = Document()
# Add title
title = doc.add_heading('Document Title', 0)
title.alignment = WD_ALIGN_PARAGRAPH.CENTER
# Add sections
doc.add_heading('Section 1', level=1)
doc.add_paragraph('Content for section 1.')
# Add table
table = doc.add_table(rows=3, cols=3)
table.style = 'Table Grid'
# Save document
doc.save('output.docx')
print("Document created successfully")
EOF
3. General File Operations
python3 << 'EOF'
import json
import os
# Read input file
with open('input.json', 'r') as f:
data = json.load(f)
# Process data
result = {'processed': True, 'items': len(data)}
# Write output
with open('output.json', 'w') as f:
json.dump(result, f, indent=2)
print(f"Processed {result['items']} items")
EOF
Best Practices
- Install dependencies first: Run
pip install package-name -qbefore the Python block if packages aren't guaranteed to be available - Verify file paths: Files are read from and written to the current working directory
- Add print statements: Include progress/output messages to verify execution succeeded
- Close resources: Explicitly close matplotlib figures and file handles
- Handle errors gracefully: Add try/except blocks for production code
Troubleshooting
| Issue | Solution |
|---|---|
| Module not found | Add pip install <module> -q before Python block |
| File not found | Verify file exists in current directory with ls |
| Permission denied | Check file permissions and directory write access |
| Syntax errors | Ensure proper Python indentation within heredoc |
Advantages Over execute_code_sandbox
- No initialization overhead - runs immediately in existing shell
- Persistent environment - maintains state across multiple commands
- Direct file system access - no sandbox isolation issues
- Full system Python - access to all installed packages
- Reliable for large files - no sandbox size restrictions
04 同仓库更多 Skills
agentpilot
Set up AgentPilot and use its single entry to prepare missing inputs and run configured RSI experiments. Use when the user requests AgentPilot installation or work with AgentPilot.
remember
Review auto-memory entries and propose promotions to OPENSPACE.md, OPENSPACE.local.md, or retained auto-memory topics; detect duplicates, stale facts, conflicts, and ambiguous entries before making changes.
skill-discovery
Search reusable OpenSpace skills locally, and browse cloud packages step by step when a cloud skill may help. Reusing proven skills saves tokens, improves reliability, and extends your capabilities beyond built-in tools.
delegate-task
Delegate tasks to OpenSpace — a full-stack autonomous worker for coding, DevOps, web research, and desktop automation, backed by an extensive MCP tool and skill library. Skills auto-improve through use, reducing token consumption over time. A cloud community lets agents share and collectively evolve reusable skills.
write-special-chars-ts-check
Workaround for write_file failures caused by special characters (apostrophes, backticks, template literals) using a Python heredoc script, plus a reliable TypeScript type-checking step that filters output to only the newly-written files to avoid being misled by pre-existing errors.
write-special-chars-readback
Workaround for write_file failures caused by special characters (apostrophes, backticks, template literals) using a Python heredoc script, with mandatory post-write verification via read_file and cleanup of /tmp helper scripts.