---
title: Eidolon Cognitive Tutor
emoji: 🧠
colorFrom: purple
colorTo: blue
sdk: gradio
sdk_version: 4.0.0
app_file: app.py
pinned: false
license: apache-2.0
---

# 🧠 Eidolon Cognitive Tutor

**Interactive AI Tutor with 6 Learning Modes, Adaptive Difficulty, and Gamification**

> Learn Anything, Your Way — Personalized, Interactive, Engaging

---

## 🚀 Try It Now!

This Space runs in **Demo Mode** by default - no API keys required!

### Features
- 📚 **6 Learning Modes**: Socratic, ELI5, Technical, Analogy, Code, Standard
- 🎯 **Adaptive Difficulty**: 1-5 scale from Beginner to Expert
- 🎭 **Tutor Personas**: Friendly, Strict, Enthusiastic, Professional, Playful
- 🏆 **Gamification**: Achievements, streaks, progress tracking
- ⚡ **Interactive UI**: Typing animation, prompt enhancement, examples

---

## 🔧 Configuration (Optional)

To connect a real AI model instead of demo responses:

### Option 1: Set Environment Variables
1. Go to **Settings** → **Variables and secrets**
2. Add these variables:
   - `DEMO_MODE` = `0` (disable demo mode)
   - `INFERENCE_API_URL` = your inference endpoint
   - `INFERENCE_API_KEY` = your API key (if needed)

### Option 2: Keep Demo Mode (Default)
The Space works perfectly in demo mode! It shows:
- How learning modes adapt responses
- Difficulty scaling (1-5)
- Persona variations
- All UI features

**Demo mode is ideal for showcasing the platform without requiring API costs.**

---

## 📚 Documentation

- **[GitHub Repository](https://github.com/Zwin-ux/Eidolon-Cognitive-Tutor)** - Full source code
- **[Feature Showcase](https://github.com/Zwin-ux/Eidolon-Cognitive-Tutor/blob/main/FEATURES.md)** - Complete feature list
- **[Quick Start Guide](https://github.com/Zwin-ux/Eidolon-Cognitive-Tutor/blob/main/QUICKSTART.md)** - 30-second onboarding

---

## 🎯 What Makes This Special?

Unlike typical AI demos, this tutor offers:
- ✅ Multiple learning approaches (not one-size-fits-all)
- ✅ Difficulty adaptation (scales to your level)
- ✅ Personality customization (choose teaching style)
- ✅ Progress tracking (gamified journey)
- ✅ Full functionality in demo mode (no API required)

---

## 🛠️ Tech Stack

- **Gradio 4.0+** - Interactive UI
- **FastAPI** - Backend API (Vercel deployment)
- **SQLite** - Conversation history
- **Vanilla JS** - Static UI (public/index.html)

---

## 📖 How to Use

1. **Select a Learning Mode** - Choose how you want to learn
2. **Adjust Difficulty** - Drag the slider (1=Beginner, 5=Expert)
3. **Pick a Persona** - Choose your tutor's style
4. **Ask Questions** - Type anything or click examples
5. **Track Progress** - Watch your stats grow!

---

## 🏆 Achievements to Unlock

- 🌟 **Getting Started** - Ask your first question
- 🎓 **Curious Learner** - Ask 10 questions
- 🔥 **Knowledge Seeker** - Ask 50 questions
- 🎨 **Mode Master** - Try all 6 learning modes

---

**Built with ❤️ for personalized learning**