README_SPACE.md

metadata

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 - Full source code
• Feature Showcase - Complete feature list
• Quick Start Guide - 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