swarmauri_tool_jupyterruncell 0.10.0.dev1

A tool designed to execute a single code cell in an IPython interactive shell, mimicking notebook cell execution.

---

Swarmauri Tool Jupyter Run Cell

Executes a code string inside the current IPython kernel and captures stdout/stderr/error text.

Features

• Runs arbitrary Python snippets with optional timeout.
• Returns success, cell_output, and error_output keys.
• Designed for use inside running notebooks or IPython sessions.

Prerequisites

• Python 3.10 or newer.
• Running within IPython/Jupyter environment.

Installation

# pip
pip install swarmauri_tool_jupyterruncell

# poetry
poetry add swarmauri_tool_jupyterruncell

# uv (pyproject-based projects)
uv add swarmauri_tool_jupyterruncell

Quickstart

from swarmauri_tool_jupyterruncell import JupyterRunCellTool

runner = JupyterRunCellTool()
result = runner(code="print('Hello from Swarmauri!')", timeout=5)

if result["success"]:
    print("stdout:", result["cell_output"])
else:
    print("error:", result["error_output"])

Tips

• Set timeout=0 (or omit) to disable execution timeouts.
• Capture error_output to diagnose exceptions raised by the executed code.
• Use alongside other notebook automation tools (execute, export, etc.) to build richer pipelines.

Want to help?

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