joshxt/safeexecute

SafeExecute

镜像概述和主要用途

SafeExecute是一个用于在容器中安全执行Python代码的模块，旨在配合语言模型使用，使代码能够在与主机（计算机或服务器）隔离的安全环境中运行，避免直接在主机系统执行带来的风险。

核心功能和特性

安全隔离环境

• 代码在独立容器中执行，与主机系统完全隔离，防止***代码或错误操作对主机造成影响。

预装常用Python包

容器默认包含以下常用科学计算、数据分析及可视化包，无需额外配置即可直接使用：

• numpy
• matplotlib
• seaborn
• scikit-learn
• yfinance
• scipy
• statsmodels
• sympy
• bokeh
• plotly
• dash
• networkx
• pyvis
• pandas
• agixtsdk

动态包安装支持

若代码中包含pip install <package>语句，模块会在执行代码前自动在容器内安装指定包，确保代码依赖满足。

代码块自动解析

可直接传入语言模型生成的消息内容，模块会自动识别并提取其中的Python代码块进行执行，无需手动处理文本格式。

使用场景和适用范围

• 语言模型代码执行：作为语言模型的辅助工具，安全执行模型生成的Python代码，如处理用户的数据分析请求、运行算法示例等。
• 数据分析与科学计算：支持执行包含数据处理、统计分析、图表生成等任务的代码，预装包覆盖常见科学计算需求。
• 教学与实验环境：在教学或实验场景中，提供隔离的代码运行环境，适合练习或演示代码执行。

使用方法和配置说明

安装

通过pip安装SafeExecute模块：

bash
pip install safeexecute

使用示例

将包含Python代码的文本传入execute_python_code函数，模块会解析代码并在容器中执行，返回执行结果。

python
from safeexecute import execute_python_code

# 示例：执行简单打印语句
code = "print('Hello, World!')"
result = execute_python_code(code=code)
print(result)

动态安装包示例

若代码中包含pip install命令，模块会先安装对应包再执行代码：

python
code = """
pip install requests
import requests
response = requests.get('https://api.example.com')
print(response.status_code)
"""
result = execute_python_code(code=code)
print(result)

执行后，result变量将包含代码执行的输出信息，包括打印内容、错误信息（若有）等。