How zaintahir2025/neuroscript-ai works
NeuroScript AI is an offline-first accessible study app: students capture notes, review OCR text, generate structured lessons, then study flashcards or explore concept maps. README documents the client pipeline and privacy boundary; sampled server code confirms proxy validation, rate limiting, provider dispatch, and Gemini calls. Flutter implementation details were not sampled, so client-stage edges rely on README statements; planned roadmap capabilities are omitted.
Main entry points: Program.cs Proxy endpoints · lesson_overview_screen.dart Lesson overview · capture_screen.dart Capture screen · image_preprocessor.dart Image processing
Components 20
Note capture
- Capture screen
lib/features/capture/capture_screen.dart - Image processing
lib/services/image_preprocessor.dart - On-device OCR
lib/services/ocr_service.dart - Transcript review
lib/features/ocr_review/ocr_review_screen.dart
Study experience
- Lesson library
lib/features/library/library_screen.dart - Lesson overview
lib/features/lesson/lesson_overview_screen.dart - Flashcard review
lib/features/review/flashcard_review_screen.dart - Concept map
lib/features/concept_map/concept_map_screen.dart - Accessibility settings
lib/features/settings/settings_screen.dart
Client services
- Proxy client
lib/services/proxy_service.dart - Encrypted SQLite
lib/data/database/database.dart - Leitner scheduler
lib/services/leitner_scheduler.dart
AI proxy
- Proxy endpoints
server/NeuroScriptProxy/Program.cs - Lesson contracts
server/NeuroScriptProxy/Models/LessonContracts.cs - Rate limiter
server/NeuroScriptProxy/Services/RateLimiter.cs - Generator interface
server/NeuroScriptProxy/Services/ILessonGenerator.cs - Gemini generator
server/NeuroScriptProxy/Services/GeminiLessonGenerator.cs - Mock generator
server/NeuroScriptProxy/Services/MockLessonGenerator.cs
Other components
- Student
- Google Gemini
Connections 19
- Student → Capture screen: captures notes
README.md - Capture screen → Image processing: preprocesses images
README.md - Image processing → On-device OCR: recognizes text
README.md - On-device OCR → Transcript review: reviews transcript
README.md - Transcript review → Proxy client: requests synthesis
README.md - Proxy client → Proxy endpoints: sends lesson request
README.md - Proxy endpoints → Lesson contracts: accepts request
server/NeuroScriptProxy/Program.cs - Proxy endpoints → Rate limiter: checks quota
server/NeuroScriptProxy/Program.cs - Proxy endpoints → Generator interface: dispatches generation
server/NeuroScriptProxy/Program.cs - Proxy endpoints → Gemini generator: registers provider
server/NeuroScriptProxy/Program.cs - Proxy endpoints → Mock generator: registers fallback
server/NeuroScriptProxy/Program.cs - Gemini generator → Google Gemini: calls API
server/NeuroScriptProxy/Services/GeminiLessonGenerator.cs - Proxy endpoints → Encrypted SQLite: returns lesson for storage
- Encrypted SQLite → Lesson library: provides saved lessons
- Lesson library → Lesson overview: opens lesson
- Lesson overview → Flashcard review: offers flashcards
README.md - Flashcard review → Leitner scheduler: schedules recall
README.md - Lesson overview → Concept map: shows concept map
README.md - Student → Accessibility settings: chooses profile
README.md