Guided Learning is unresponsive after local deployment

[xjtai]

Guided Learning is unresponsive after local deployment

[pauldev-hub]

Hey @xjtai ,

Root cause:
The logs show the real problem clearly:
RuntimeWarning: coroutine 'logging.async_success_handler' was never awaited
self._queue = None

This is an async event loop conflict — the logging_worker is trying to fire an async callback (async_success_handler) from a sync context. On Windows this is worse because Uvicorn defaults to asyncio event loop instead of uvloop, and nest_asyncio isn't applied, causing the coroutine to be created but never scheduled.

Fix — three steps:

1. Add nest_asyncio patch at startup
   In your start_web.py or wherever the server initializes, add at the very top:
   import nest_asyncio
   nest_asyncio.apply()

2. Use asyncio event loop explicitly on Windows
   In your server startup script:
   import asyncio
   import sys

if sys.platform == "win32":
asyncio.set_event_loop_policy(asyncio.WindowsSelectorEventLoopPolicy())

3. Check the session state file

Guided Learning sessions are stored at:

data/user/guide/session_{session_id}.json
Delete any malformed/stale session JSON files and retry creating a new session — the "No learning history yet" blank panel is caused by a session that was created server-side (create_session 200 OK) but the async page generation never completed.

👍 If this helped you, please mark it as the answer — it helps others in the community who run into the same issue find the solution faster!