🚀 Lintrix - AI-Powered Python Learning Platform

Learn to code by THINKING, not copying answers

---

📌 About the Project

Lintrix is an interactive Python programming learning platform that uses Gemini 3 to offer a unique and personalized learning experience.

🎯 Problem We Solve

Learning programming alone can be frustrating. Traditional AI tools give you the answer directly, but you don't actually learn. Lintrix offers a Socratic AI tutor that guides students with questions instead of ready-made answers, promoting critical thinking and real understanding.

---

✨ Main Features (Powered by Gemini 3)

1. 🎓 Socratic AI Tutor

Intelligent chat that asks questions instead of giving direct answers, helping students develop logical reasoning and problem-solving skills.

2. 🔀 Algorithm Flow Visualization (Mermaid)

Automatically generates visual diagrams of the algorithm flow from the code, helping students understand the logic step by step.

3. ⚡ Big O Complexity Analysis

Analyzes the code and shows time and space complexity with colored badges and optimization suggestions.

4. 🎨 Personalized Exercise Generation

The AI creates unique exercises based on the topic and difficulty level chosen by the student.

5. 📚 Deep-Dive Explanations

When you don't understand a concept, ask the AI to explain any topic in depth - it adapts to your level.

---

🛠️ Technologies

Frontend	Backend	AI
React 18	FastAPI	Gemini 3 Flash
Tailwind CSS	Python 3.11	Gemini 3 Multimodal
Shadcn UI	Piston API	-
Vite	Docker	-
Firebase	Cloud Run	-
Mermaid.js	-	-

---

🚀 Run Locally

Prerequisites

• Node.js 20+
• Python 3.11+
• Gemini API Key

Frontend

cd lintrix
npm install
npm run dev

Backend

cd lintrix/backend
pip install -r requirements.txt
python main.py

Access: http://localhost:5173

---

☁️ Deploy

Cloud Run

# Backend
cd backend
gcloud builds submit --tag gcr.io/YOUR-PROJECT/lintrix-backend
gcloud run deploy lintrix-backend --image gcr.io/YOUR-PROJECT/lintrix-backend --platform managed --allow-unauthenticated

# Frontend  
cd ..
gcloud builds submit --tag gcr.io/YOUR-PROJECT/lintrix-frontend
gcloud run deploy lintrix-frontend --image gcr.io/YOUR-PROJECT/lintrix-frontend --platform managed --allow-unauthenticated

---

📊 Project Structure

lintrix/
├── src/
│   ├── components/       # React Components
│   ├── pages/            # Application Pages
│   ├── services/         # Services (Gemini, CodeRunner)
│   └── data/             # Exercises and Curriculum
├── backend/
│   ├── main.py           # FastAPI API
│   ├── piston_executor.py # Code Executor
│   └── security.py       # Security Validation
└── Dockerfile

---

🎮 How to Use

1. Configure API Key - Go to settings and enter your Gemini key
2. Choose an Exercise - From the learning path or exercises page
3. Write Code - Use the integrated Monaco editor
4. Execute - Test your code with real test cases
5. Ask the Tutor - The AI chat guides you through questions, not answers

---

🏆 Hackathon Submission

This project was built for the Gemini 3 Hackathon demonstrating 5 innovative uses of Gemini AI:

Feature	Gemini Usage
Socratic Tutor	Interactive Q&A that promotes thinking
Flowchart Generation	Mermaid diagrams from problem description
Exercise Generator	Unique problems adapted to skill level
Deep Explanations	Topic explanations within context
Code Analysis	Error detection and improvement suggestions

---

👥 Team

Developed for the Gemini 3 Hackathon by AI and Education enthusiasts.

---

📄 License

MIT License - Feel free to use for studies and personal projects.

---

⭐ Star this repo if you found it helpful!

Live Demo • Report Bug • Request Feature