Agent skill

Jupyter Live Kernel

by taracodlabs in taracodlabs/aiden

Stateful Jupyter kernel — variables persist across cells (hamelnb)

Apache-2.0Auto-check passedData & Analytics

Install Jupyter Live Kernel

skills CLI
$ npx skills add taracodlabs/aiden --skill jupyter-live-kernel -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install taracodlabs/aiden jupyter-live-kernel --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/taracodlabs/aiden.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/jupyter-live-kernel .claude/skills/jupyter-live-kernel && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
jupyter-live-kernel
GitHub stars
851
Token cost
~949 tokens
SKILL.md length
280 words
Files
2
Skills in repo
63
Repo updated
First seen
Licence
Apache-2.0

At a glance

Stateful Jupyter kernel — variables persist across cells (hamelnb)

  • Works in 5 steps: Install hamelnb (stateful kernel CLI) → Start a kernel and run cells (hamelnb) → Execute a notebook file → …
  • Tasks that involve Jupyter notebooks
  • SKILL.md covers When to Use, How to Use, Examples and Cautions
  • Calls pip and jupyter

What it does

Jupyter Live Kernel is an agent skill from taracodlabs/aiden. Stateful Jupyter kernel — variables persist across cells (hamelnb)

Its SKILL.md is about 950 tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `skill.json`).

It sits in Data & Analytics, covering Jupyter notebooks. It works with Jupyter and Python. The repository describes itself as: Aiden — an autonomous AI agent and work engine built solo. It can operate your browser, terminal, files, apps, APIs, skills and tools, remember context, recover from failures… The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Jupyter notebooks

Example prompts

  • “/jupyter-live-kernel”

Requirements

  • Python 3

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Install hamelnb (stateful kernel CLI)
  2. Start a kernel and run cells (hamelnb)
  3. Execute a notebook file
  4. Run Python code in a Jupyter kernel via Python API
  5. Inject variables into a running kernel

What it can do on your machine

Read from SKILL.md and the folder at commit 3704204. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • pip
    • jupyter

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use pip, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Jupyter Live Kernel loads about 949 tokens when it runs. Until then it costs about 22 tokens; SKILL.md has 280 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~22
When it runs · the whole SKILL.md, loaded when a task matches
~949

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from taracodlabs/aiden at commit 3704204, republished under its Apache-2.0 licence (© taracodlabs). 280 words, ~949 tokens.

Download SKILL.mdSave it as .claude/skills/jupyter-live-kernel/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
jupyter-live-kernel
description
Stateful Jupyter kernel — variables persist across cells (hamelnb)
category
developer
version
1.0.0
origin
aiden
license
Apache-2.0
tags
jupyter, notebook, kernel, python, data-science, ipython, stateful, cells, pandas

Jupyter Live Kernel Execution

Run Python code in a persistent Jupyter kernel so that variables, imports, and state carry over between executions — exactly like working in a notebook, but from the CLI.

When to Use

  • User wants to run data analysis across multiple code cells with shared state
  • User wants to explore a dataset step by step
  • User wants to run ML training and inspect intermediate results
  • User wants to execute a .ipynb notebook file from the command line
  • User wants to maintain a REPL-like Python session with persistent variables

How to Use

1. Install hamelnb (stateful kernel CLI)
powershell
pip install hamelnb
# or use jupyter directly
pip install jupyter
2. Start a kernel and run cells (hamelnb)
powershell
# Start a persistent kernel session (keeps running between calls)
hamelnb start --name datasession

# Execute a code snippet in the named session
hamelnb run datasession "import pandas as pd; df = pd.read_csv('data.csv'); print(df.shape)"

# Execute next cell — df variable is still available
hamelnb run datasession "print(df.describe())"

# Stop session when done
hamelnb stop datasession
3. Execute a notebook file
powershell
# Run all cells in a notebook and save output
jupyter nbconvert --to notebook --execute analysis.ipynb --output analysis_out.ipynb

# Run and convert output to HTML for viewing
jupyter nbconvert --to html --execute analysis.ipynb --output report.html
4. Run Python code in a Jupyter kernel via Python API
python
import jupyter_client, queue

km = jupyter_client.KernelManager(kernel_name="python3")
km.start_kernel()
kc = km.client()
kc.start_channels()
kc.wait_for_ready(timeout=30)

def run_cell(code):
  kc.execute(code)
  outputs = []
  while True:
    try:
      msg = kc.get_iopub_msg(timeout=10)
      if msg["msg_type"] == "stream":
        outputs.append(msg["content"]["text"])
      elif msg["msg_type"] == "execute_result":
        outputs.append(msg["content"]["data"].get("text/plain",""))
      elif msg["msg_type"] == "status" and msg["content"]["execution_state"] == "idle":
        break
    except queue.Empty:
      break
  return "".join(outputs)

print(run_cell("import pandas as pd; df = pd.read_csv('data.csv'); df.shape"))
print(run_cell("df.describe()"))   # df is still in scope!
km.shutdown_kernel()
5. Inject variables into a running kernel
python
# Use run_cell from step 4 to inject values
run_cell("x = 42; y = [1, 2, 3]")
result = run_cell("print(x * 2, sum(y))")

Examples

"Load sales.csv and show the top 10 rows, then plot revenue by month" → Use step 4: run cell 1 to load and preview the CSV, run cell 2 to group by month and show results — df persists between calls.

"Execute my analysis.ipynb notebook and give me the output" → Use step 3 with jupyter nbconvert --to notebook --execute.

"Explore the wine quality dataset — check correlations step by step" → Use hamelnb (step 2) to build up analysis iteratively with named session.

Cautions

  • Kernel sessions consume memory for as long as they run — always km.shutdown_kernel() when done
  • Long-running cells (ML training) will block until complete — set reasonable timeouts
  • nbconvert --execute re-runs all cells from scratch — it does not resume a previous state
  • hamelnb is a third-party tool — verify it is installed with pip show hamelnb before use
  • Never pass user secrets as inline code strings — use environment variables or config files instead

© taracodlabs, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/jupyter-live-kernel of taracodlabs/aiden.

  • SKILL.md
  • skill.json

Open the folder on GitHubat commit 3704204

Compare with similar skills

Jupyter Live Kernel next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Jupyter Live Kernel compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Jupyter Live Kernel this skilltaracodlabs/aiden851—~949Automated safety check: PassApache-2.0
Save Research Notebooknapjon/krisk117—~702Automated safety check: PassBSD-3-Clause
Export ML Notebookprobabl-ai/skills138—~1kAutomated safety check: PassBSD-3-Clause
Jupyter Live KernelRedWoodOG/Hermes-Desktop1775 repos~1.4kAutomated safety check: PassMIT
Bio Reporting Quarto ReportsGPTomics/bioSkills1.2k1 repos~2.4kAutomated safety check: PassMIT
Marimobrycewang-stanford/Auto-Empirical-Research-Skills4.5k—~2.8kAutomated safety check: PassCustom licence

Similar skills

  • Convert a completed data-analysis conversation into evidence-backed, reproducible living research through the Krisk MCP server.

    117 GitHub stars~702 tokensUpdated 7 days ago
    Data & AnalyticsAuto-check passed
  • Export ML Notebook

    probabl-ai/skills

    Convert a jupytext percent %% Python file into an executed .ipynb with cell outputs.

    138 GitHub stars~1k tokensUpdated yesterday
    Data & AnalyticsAuto-check passed
  • Jupyter Live Kernel

    RedWoodOG/Hermes-Desktop

    Use a live Jupyter kernel for stateful, iterative Python execution via hamelnb.

    177 GitHub starsUsed in 5 repos~1.4k tokens
    Data & AnalyticsAuto-check passed
  • Builds reproducible Quarto reports, presentations, and websites across R, Python, and Julia, with correct engine selection, cache-vs-freeze semantics, native cross-references, parameters, and…

    1.2k GitHub starsUsed in 1 repo~2.4k tokens
    Data & AnalyticsAuto-check passed
  • Marimo

    brycewang-stanford/Auto-Empirical-Research-Skills

    Reactive Python notebook system. An agent skill from brycewang-stanford/Auto-Empirical-Research-Skills.

    4.5k GitHub stars~2.8k tokensUpdated 4 days ago
    Data & AnalyticsAuto-check passed
  • Jupytext

    ninehills/skills

    Jupyter Notebook 创建与格式转换技能。当用户提到以下任何请求时必须使用:新建/创建 notebook、Jupyter notebook、.ipynb、jupytext、py:percent、 %% cell 格式、notebook 版本控制、paired notebook、notebook 转 Python、Python 转 notebook、用纯文本写…

    280 GitHub stars~1.1k tokensUpdated 3 mo ago
    Data & AnalyticsAuto-check passed

More from taracodlabs/aiden

All 63 skills in this repo
  • Google Flights Search

    taracodlabs/aiden

    Searches Google Flights for prices, schedules and availability through browser automation with URL-based queries, and stops short of booking.

    851 GitHub stars~1.5k tokensUpdated 26 days ago
    Auto-check passed
  • OpenAI Codex CLI Bridge

    taracodlabs/aiden

    Delegates code generation, editing and explanation tasks to the OpenAI Codex CLI, with commands for interactive, auto-edit, question-only and model-specific runs.

    851 GitHub starsUsed in 1 repo~826 tokens
    Auto-check passed
  • Google Hotels Search

    taracodlabs/aiden

    Searches Google Hotels through the agent-browser tool for prices, ratings, amenities and availability, building a search URL from the location and dates and reporting a results table.

    851 GitHub stars~1.5k tokensUpdated 26 days ago
    Auto-check passed
  • Generates dark-themed architecture, component, data-flow and network diagrams as self-contained HTML and SVG files that open in any browser.

    851 GitHub stars~1.3k tokensUpdated 26 days ago
    Auto-check passed
  • Aggregates holdings across Zerodha, Upstox and Angel One and normalizes order parameters into one format, with confirmation required before any routing.

    851 GitHub stars~1.1k tokensUpdated 26 days ago
    Auto-check passed
  • arXiv Paper Search

    taracodlabs/aiden

    Searches arXiv by keyword, category, author or paper ID through its public API and downloads PDFs, with no API key needed.

    851 GitHub stars~1k tokensUpdated 26 days ago
    Auto-check passed

Works with

Questions about Jupyter Live Kernel

What does Jupyter Live Kernel do?

Stateful Jupyter kernel — variables persist across cells (hamelnb). Jupyter Live Kernel is an agent skill from taracodlabs/aiden.

When should I use Jupyter Live Kernel?

Jupyter Live Kernel fits situations like: tasks that involve Jupyter notebooks.

How do I install Jupyter Live Kernel in Claude Code?

Run `npx skills add taracodlabs/aiden --skill jupyter-live-kernel -a claude-code`. Or copy the skill folder (skills/jupyter-live-kernel in taracodlabs/aiden) into .claude/skills/jupyter-live-kernel in your project. Claude Code loads it when a task matches its description.

How do I install Jupyter Live Kernel in Codex?

Run `npx skills add taracodlabs/aiden --skill jupyter-live-kernel -a codex`. Or copy the skill folder (skills/jupyter-live-kernel in taracodlabs/aiden) into .agents/skills/jupyter-live-kernel in your project. Codex loads it when a task matches its description.

Can I use Jupyter Live Kernel in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add taracodlabs/aiden --skill jupyter-live-kernel -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/jupyter-live-kernel, .gemini/skills/jupyter-live-kernel, .github/skills/jupyter-live-kernel and .opencode/skills/jupyter-live-kernel in your project.

What does Jupyter Live Kernel need to run?

Going by SKILL.md and its folder, Jupyter Live Kernel needs the command-line tools its instructions call (pip and jupyter). Our summary lists: Python 3.

Does Jupyter Live Kernel access the network?

SKILL.md contains no URLs. Its commands use pip, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Jupyter Live Kernel safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Jupyter Live Kernel use?

Jupyter Live Kernel is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Jupyter Live Kernel use?

About 949 tokens (SKILL.md is roughly 3.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Jupyter Live Kernel?

Skills that share tags, products or a category with Jupyter Live Kernel: Save Research Notebook (napjon/krisk, 117 stars), Export ML Notebook (probabl-ai/skills, 138 stars), Jupyter Live Kernel (RedWoodOG/Hermes-Desktop, 177 stars) and Bio Reporting Quarto Reports (GPTomics/bioSkills, 1.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Jupyter Live Kernel?

taracodlabs (a GitHub organization) maintains it in taracodlabs/aiden, which has 851 GitHub stars. The repository holds 63 skills in this directory. The repository was last updated on September 13, 2026.

Source: taracodlabs/aiden on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.