A newer version of the Gradio SDK is available: 6.20.0
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