---
title: Socratic Lens
emoji: 📚
colorFrom: blue
colorTo: indigo
sdk: docker
pinned: false
license: mit
---

# 📚 Socratic Lens

An AI-powered educational companion that analyzes images and documents to create beautiful, structured learning summaries.

## Features

- 🔍 **Image & Document Analysis** - Upload photos or PDFs of textbook pages
- 📷 **Camera Capture** - Take photos directly from your device
- 📖 **Wikipedia Integration** - Auto-fetches related Wikipedia articles
- 💬 **Ask Questions** - Interactive Q&A about the analyzed content
- 📝 **Quiz Me** - Generate customizable quizzes (MCQ/Written)
- 🎨 **Beautiful UI** - Clean, minimal design with dark mode support

## Tech Stack

- **Framework**: Next.js 16 (App Router)
- **AI**: Google Gemini 2.5 Flash
- **Styling**: Tailwind CSS
- **Language**: TypeScript

## Environment Variables

Set the following in your Hugging Face Space settings:

```
GEMINI_API_KEY=your_google_gemini_api_key
```

## Local Development

```bash
# Install dependencies
npm install

# Set up environment
cp .env.example .env.local
# Add your GEMINI_API_KEY to .env.local

# Run development server
npm run dev
```

## Deployment

This app is configured for deployment on Hugging Face Spaces using Docker.

1. Create a new Space on Hugging Face
2. Select "Docker" as the SDK
3. Push this repository to the Space
4. Add `GEMINI_API_KEY` in Space Settings > Repository Secrets

## License

MIT