| --- |
| title: AI Tutor |
| emoji: 📚 |
| colorFrom: pink |
| colorTo: indigo |
| sdk: gradio |
| sdk_version: 5.49.1 |
| app_file: app.py |
| pinned: false |
| short_description: Ai tutor |
| --- |
| |
| 📚 AI-Python-Tutor |
|
|
| An Autonomous Python Tutor that teaches through hands-on code execution — writing Python files, running them, analyzing errors, and providing curated learning resources using MCP tools and autonomous reasoning. |
|
|
| 🚀 Project Overview |
|
|
| AI-Python-Tutor ("Vibe Coding Academy") is an AI-powered educational agent that uses MCP (Model Context Protocol) servers to deliver interactive coding lessons. |
| Unlike standard chatbots, this agent can: |
|
|
| Write real Python files to a sandbox environment |
|
|
| Execute Python code and show real output |
|
|
| Debug errors live with explanations |
|
|
| Curate videos, articles, quizzes, and documentation dynamically |
|
|
| Use LangGraph for structured and modular lesson planning |
|
|
| It demonstrates the power of MCP tools (write_file, run_python_script) combined with autonomous reasoning to create a full teaching workflow. |
| |
| 🎯 Key Features |
| |
| Interactive Coding Lessons |
| Ask the tutor to teach any topic (e.g., Decorators, Recursion), and it explains the concept using live code. |
| |
| Live Code Execution |
| The agent writes .py files and executes them using MCP tools, showing real output. |
| |
| Learning Dashboard |
| A dedicated panel showing: |
| |
| 📺 Recommended Videos |
| |
| 📚 Articles & Documentation |
| |
| 🧠 Knowledge Check Quizzes |
| |
| Focus Mode UI |
| A “Slate” themed distraction-free full-screen learning interface. |
| |
| MCP Integration |
| Modular architecture using server.py to handle safe file operations and code execution. |
| |
| 🛠️ How to Use |
| |
| Open the HuggingFace Space |
| |
| Ask a question such as: |
| |
| "How do Python dictionaries work?" |
| |
| "Write a script for Fibonacci numbers." |
| |
| Watch the agent: |
| |
| Explain the concept |
| |
| Write the Python file (e.g., demo_dict.py) |
|
|
| Execute it and show the output |
|
|
| Explore the Learning Dashboard for videos, articles, and quizzes |
|
|
| Use Focus Mode to switch to a clean, immersive UI |
|
|
| 🎥 Demo Video |
|
|
| [Insert your Demo Video Link Here] |
|
|
| 👥 Team |
| Name HuggingFace Username |
| [Member Name] @[username] |
| [Member Name] @[username] |
|
|
| All members have joined the Hackathon organization and registered for the event. |
|
|
| ⚙️ Requirements |
|
|
| Gradio app with MCP server support |
|
|
| NEBIUS_API_KEY environment variable for LLM inference (openai/gpt-oss-20b) |
|
|
| Python dependencies: |
| gradio, langgraph, mcp, langchain_openai |
| |
| 🏷️ Track Tag |
| |
| mcp-in-action-track-creative |
| |
| |
