Add your description here
Project description
Claude Tutor
A terminal-based programming tutor powered by Claude. Built with Textual and the Claude Agent SDK.
Overview
Claude Tutor is a TUI (Terminal User Interface) application designed to help you learn programming concepts. Unlike a typical coding assistant, Claude Tutor focuses on teaching rather than writing code for you. It will:
- Explain concepts clearly and thoroughly
- Guide you toward understanding with questions and hints
- Provide small examples to illustrate concepts
- Encourage you to write code yourself
- Review code you share, pointing out what works well and what could be improved
Installation
uv sync
Or install from PyPI:
uvx claude_tutor
Running
uv run python app.py
Using the TUI
When you launch Claude Tutor, you'll see a simple interface with:
- A welcome header at the top
- A chat log area in the middle showing your conversation
- A text input field at the bottom for typing messages
Type your programming questions in the input field and press Enter to send. Claude's responses will appear in the chat log. The interface uses color-coded panels to distinguish between different message types:
- Blue - Your messages
- Red - Claude's responses
- Grey - Tool usage (when Claude reads files in your codebase)
- Green - Slash command feedback
Slash Commands
| Command | Description |
|---|---|
/help |
Shows a list of available commands. |
/clear |
Clears the conversation history and starts fresh. Your settings are preserved. |
/tutor |
Toggles tutor mode on/off. When on (default), Claude acts as a teacher. When off, Claude responds normally without the tutoring constraints. |
/togglewebsearch |
Toggles web search on/off. When on, Claude can use WebSearch and WebFetch tools to look up information online. Disabled by default. |
Tech Stack
- Python 3.13+
- Textual - TUI framework
- Claude Agent SDK - Claude integration
- uv - Package manager
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file claude_sdk_tutor-0.1.4.tar.gz.
File metadata
- Download URL: claude_sdk_tutor-0.1.4.tar.gz
- Upload date:
- Size: 80.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.28 {"installer":{"name":"uv","version":"0.9.28","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e2a252145df13ee2523f47febf01f82938092652fa440d7cd0bc6da60e947c24
|
|
| MD5 |
540b3b697b4bdb2b024469cfb3ab81f5
|
|
| BLAKE2b-256 |
c4690c0ad16e3d040b2231b67d835e2f1f5213f3e95ca2fecc2733f350bb8c4a
|
File details
Details for the file claude_sdk_tutor-0.1.4-py3-none-any.whl.
File metadata
- Download URL: claude_sdk_tutor-0.1.4-py3-none-any.whl
- Upload date:
- Size: 5.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.28 {"installer":{"name":"uv","version":"0.9.28","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2843725bcb13c46b427695274cfa7017eaff06bf564477c0b17fa39806e1441f
|
|
| MD5 |
897ac10209da0906f67263d00bb55d8d
|
|
| BLAKE2b-256 |
637636e5c35075c0c967c1189d76a5e4f9c3ab5ddf36e7448e499c9455e9a1e4
|
