Spaces:
Sleeping
Sleeping
File size: 2,971 Bytes
e212f94 |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 |
---
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**
|