Python Tutor Chatbot

Python Tutor Chatbot

[](https://github.com/heitor-am/python-tutor-chatbot/actions/workflows/ci.yml) [](https://github.com/heitor-am/python-tutor-chatbot/actions/workflows/deploy.yml) [](https://www.python.org/downloads/release/python-3120/) [](#testing) [](LICENSE)

Conversational Python tutor — Chainlit UI on top of LangChain `create_agent` (the modern canonical pattern; `RunnableWithMessageHistory` legacy avoided per current docs) with thread-based memory via LangGraph `InMemorySaver`. Talks to OpenRouter behind a single `ChatOpenAI` client.

**Live:**

Quickstart

git clone git@github.com:heitor-am/python-tutor-chatbot.git
cd python-tutor-chatbot
uv sync --all-extras

cp .env.example .env
# edit .env and set OPENROUTER_API_KEY=sk-or-...

make dev
# open http://localhost:8000

Or just hit production: . Fly auto-stops the machine after idle, so the first message after a quiet period pays a 2-3s cold-start.

What it does

• Answers Python questions in PT-BR with executable examples and a clear "explain reasoning before code" structure.
• Remembers the conversation within a session via per-tab thread_id + LangGraph InMemorySaver.
• Refuses off-topic questions in one polite sentence (smoke-verified end-to-end against real OpenRouter — see PR #3 description for the test transcript).
• Streams tokens as they arrive (via agent.astream(stream_mode="messages") piped to cl.Message.stream_token()).
• Logs structured thumbs-up / thumbs-down feedback.
• F