swarmauri_tool_jupyterexecutecell 0.10.0

A tool designed to execute a single code cell in a running Jupyter kernel using jupyter_client, capturing its output and errors.

---

Swarmauri Tool Jupyter Execute Cell

Executes Python code in the active Jupyter kernel and captures stdout/stderr/errors for downstream tooling.

Features

• Accepts raw code strings and optionally a timeout.
• Returns a dict with stdout, stderr, and error keys.
• Built on jupyter_client to talk to the running kernel.

Prerequisites

• Python 3.10 or newer.
• Jupyter kernel running in the environment (IPython/Jupyter installed).

Installation

# pip
pip install swarmauri_tool_jupyterexecutecell

# poetry
poetry add swarmauri_tool_jupyterexecutecell

# uv (pyproject-based projects)
uv add swarmauri_tool_jupyterexecutecell

Quickstart

from swarmauri_tool_jupyterexecutecell import JupyterExecuteCellTool

code = "print('Hello from Swarmauri!')"
result = JupyterExecuteCellTool()(code, timeout=60)

print("stdout:", result["stdout"])
print("stderr:", result["stderr"])
print("error:", result["error"])

Tips

• Increase timeout for cells that perform long-running tasks.
• The tool executes in the current kernel—make sure dependencies are already imported/installed in that environment.
• Handle errors gracefully by checking the error field before using results.

Want to help?

If you want to contribute to swarmauri-sdk, read up on our guidelines for contributing that will help you get started.