---
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