How sungurulol/a3i-akademik-asistan works
A³I is a local-first academic research assistant: users work in a browser UI, send requests through a local Node backend, and receive streamed Claude Code results backed by academic-research skills. The README also documents file processing, chat memory, and document/presentation exports. Backend excerpts are partial, so some feature wiring is represented only where the README or sampled handlers support it; the macOS and Windows trees contain parallel implementations.
Main entry points: server.js Local API and stream · index.html Web interface
Components 20
User interaction
- Browser
- Web interface
macOS/frontend/index.html - Local API and stream
macOS/backend/server.js - Session and model control
macOS/backend/server.js
Academic work
- Claude Code
- Academic research skills
- Research and writing
- Qualitative analysis
- Peer review
- Guided questions
Files and exports
- Upload processing
macOS/backend/server.js - PDF parser
- MarkItDown
- DOCX and PDF export
macOS/backend/server.js - Presentation export
macOS/backend/server.js - Generated files pane
macOS/frontend/index.html
Local state
- Downloads directory
macOS/backend/server.js - Chat memory and search
macOS/backend/server.js - Chats directory
macOS/backend/server.js
Other components
- Researcher
Connections 23
- Researcher → Browser: uses
- Browser → Web interface: displays
- Web interface → Local API and stream: sends requests
- Local API and stream → Web interface: streams results
- Local API and stream → Session and model control: manages sessions
- Session and model control → Claude Code: starts and resumes
- Claude Code → Local API and stream: streams output
- Claude Code → Academic research skills: uses
- Academic research skills → Research and writing: supports
- Academic research skills → Qualitative analysis: supports
- Academic research skills → Peer review: supports
- Web interface → Guided questions: requests
- Local API and stream → Upload processing: handles uploads
- Upload processing → PDF parser: parses PDFs
- Upload processing → MarkItDown: converts other files
- Local API and stream → DOCX and PDF export: prepares exports
- Local API and stream → Presentation export: runs export skill
- DOCX and PDF export → Downloads directory: writes files
- Presentation export → Downloads directory: writes files
- Downloads directory → Generated files pane: lists downloadable files
- Local API and stream → Chat memory and search: serves chat operations
- Chat memory and search → Chats directory: reads and writes
- Generated files pane → Local API and stream: requests file list