mirrors/hermes-agent
1
0
Fork 0
mirror of https://github.com/NousResearch/hermes-agent.git synced 2026-07-24 16:54:43 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 6

docs(jupyter-live-kernel): document zmq transport fallback and disable_check_xsrf pitfalls

Browse source 
Add two pitfalls discovered when running the skill against a fresh
Jupyter server:

- Pitfall #9: When the websocket reply channel hangs on every execute
  even though the kernel actually ran (REST shows execution_state=idle
  and execution_count increments), force zmq transport with
  --transport zmq. The zmq transport uses jupyter_client directly and
  sidesteps the broken websocket layer.

- Pitfall #10: A fresh ServerApp rejects POST /api/sessions with
  "_xsrf argument missing from POST" unless you start it with
  --ServerApp.disable_check_xsrf=True. Needed for REST-only flows
  where no browser/cookie is establishing the XSRF token.
This commit is contained in:
upicat 2026-05-17 13:41:17 +08:00 • committed by Teknium
parent 9a4d1a0130
commit a4fa699a82
1 changed files with 11 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

11
optional-skills/data-science/jupyter-notebook/SKILL.md
View file

@ -160,6 +160,17 @@ uv run "$SCRIPT" restart-run-all --path <notebook.ipynb> --save-outputs --compac
8. **Occasional websocket timeouts** — some operations may timeout on first try,
especially after a kernel restart. Retry once before escalating.
9. **If websocket consistently times out on this host**, force zmq transport:
`uv run "$SCRIPT" execute --transport zmq ...`. Symptom: every execute returns
"Websocket execution may already have reached the kernel, so auto fallback was
skipped". The kernel actually ran fine (REST shows execution_state=idle and
execution_count increments) — only the websocket reply channel is broken.
zmq transport uses jupyter_client directly and sidesteps the issue.
10. **When starting a fresh server for REST-only use**, add
`--ServerApp.disable_check_xsrf=True` — otherwise POST /api/sessions returns
`"'_xsrf' argument missing from POST"` and kernel session creation fails.
## Timeout Defaults
The script has a 30-second default timeout per execution. For long-running