Python Notebooks Async

Overview

Notebook kernels own the event loop; async code must cooperate with that ownership rather than fight it. This skill covers orchestration patterns, top-level await, and compatibility constraints for .ipynb and #%% workflows.

Treat these recommendations as preferred defaults. When project constraints require deviation, call out tradeoffs and compensating controls.

When to Use

• asyncio.run() raises RuntimeError inside a notebook cell.
• Event-loop conflicts when mixing async libraries in Jupyter.
• Porting async scripts into notebook workflows.
• Orchestrating concurrent tasks (gather, TaskGroup) in IPython kernels.
• Deciding where to place reusable async logic across notebook/module boundaries.

When NOT to Use