How arunesh062/notecraft_generator works
NoteCraft AI captures meeting or class audio in a Chrome extension, sends chunks to a FastAPI backend for transcription and mode-specific note generation, then exposes DOCX downloads and saves notes to per-user Firestore history. The extension also provides Firebase authentication and history review, including export of saved notes. Backend orchestration and the extension UI are shown as separate layers. Some capture and service wiring is documented only in the README; those relationships cite it rather than implying unsampled implementation details.
Main entry points: App.jsx Recording and notes UI · finalize.py Finalize pipeline · main.py FastAPI app · chunks.py Chunk ingestion
Components 20
Extension capture
- Audio capture
extension-react/offscreen.js - Meeting-page widget
extension-react/content.jsx - Extension worker
extension-react/background.js
Note processing
- FastAPI app
backend/main.py - Chunk ingestion
backend/routers/chunks.py - Session and chunks
backend/session/store.py - Speech transcription
backend/services/stt_client.py - Finalize pipeline
backend/routers/finalize.py - Speaker mapping
backend/services/speaker_map.py - Note generation
backend/services/llm_client.py - Pipeline metrics
backend/services/metrics_logger.py - Status and download
backend/routers/status.py - DOCX export
backend/services/export.py
Identity and history
- Auth state
extension-react/src/context/AuthContext.jsx - Firebase services
extension-react/src/firebase.js - Notes history service
extension-react/src/services/notesHistory.js
Extension interface
- Recording and notes UI
extension-react/src/App.jsx - History and detail
extension-react/src/components/HistoryList.jsx
Other components
- Meeting or class
- Extension user
Connections 26
- Meeting or class → Audio capture: provides audio
Readme.md - Audio capture → Chunk ingestion: uploads chunks
Readme.md - Meeting-page widget → Recording and notes UI: hosts widget
Readme.md - Recording and notes UI → Extension worker: controls capture
Readme.md - Extension worker → FastAPI app: proxies requests
Readme.md - FastAPI app → Chunk ingestion: registers routes
backend/main.py - FastAPI app → Finalize pipeline: registers routes
backend/main.py - FastAPI app → Status and download: registers routes
backend/main.py - Chunk ingestion → Session and chunks: stores chunks
backend/routers/chunks.py - Chunk ingestion → Speech transcription: transcribes audio
backend/routers/chunks.py - Finalize pipeline → Session and chunks: reads session
backend/routers/finalize.py - Finalize pipeline → Speaker mapping: maps speakers
backend/routers/finalize.py - Finalize pipeline → Note generation: generates notes
backend/routers/finalize.py - Finalize pipeline → Pipeline metrics: records metrics
backend/routers/finalize.py - Status and download → Session and chunks: reads status
backend/routers/status.py - Status and download → DOCX export: exports DOCX
backend/routers/status.py - Extension user → Recording and notes UI: uses extension
Readme.md - Recording and notes UI → Auth state: reads auth state
extension-react/src/App.jsx - Auth state → Firebase services: observes auth
extension-react/src/context/AuthContext.jsx - Recording and notes UI → Notes history service: saves generated notes
extension-react/src/App.jsx - Notes history service → Firebase services: reads and writes
extension-react/src/services/notesHistory.js - Recording and notes UI → History and detail: shows history
extension-react/src/App.jsx - History and detail → Notes history service: loads and deletes
extension-react/src/components/HistoryList.jsx - History and detail → DOCX export: exports saved notes
Readme.md - Recording and notes UI → Status and download: checks processing
Readme.md - Recording and notes UI → DOCX export: downloads document
Readme.md