---
title: StudyFlow AI
emoji: 📚
colorFrom: green
colorTo: purple
sdk: static
app_file: index.html
pinned: false
license: mit
short_description: A private, personalized AI study copilot.
---

# StudyFlow AI

StudyFlow AI is a private study copilot built around the materials students
already use: handwritten notes, lecture slides, PDFs, calendars, flashcards,
and reminders.

The current release is an interactive frontend prototype centered on
Josephine Wendland, a multilingual teaching student from Mainz. Backend,
OCR, local model, and retrieval integrations will be added next.

## Current Experience

- Personal daily briefing and schedule
- Material upload and OCR review interface
- Connected slide, note, and AI study canvas
- Calendar and personalized learning plan
- Knowledge-gap review
- Flashcard editing and export flows
- Quiz simulation and reminders
- Local-first privacy messaging

## Run Locally

No build step is required.

```powershell
node server.js
```

Then open [http://localhost:4173](http://localhost:4173).

Python can also serve the static prototype:

```powershell
python -m http.server 4173
```

## Repository Layout

```text
assets/
  hero/          Generated Josephine illustration
  materials/     Sample note, slide, and calendar imagery
docs/design/     Reference concepts, QA, reviews, and design history
tools/           Local design and review utilities
app.js           Application views and interactions
index.html       Static Space entry point
styles.css       Responsive visual system
server.js        Tiny local development server
```

## Publication

The same Git history is pushed to:

- GitHub: source repository and development history
- Hugging Face Spaces: live static prototype

Commits created with Codex include an explicit Codex co-author trailer.

## Next Phase

The frontend will later be migrated to a Gradio/FastAPI-backed application
with OCR, document linking, local retrieval, study-plan generation, and
notification workflows.