Repository navigation
🧬 Commentarium v2.0 — Research Studio
The v1.x Streamlit line ends with v1.9.0.
v2.0 keeps the same FastAPI backend and features, but replaces the entire frontend with a fast, dark/light single-page app served directly by the API process at http://localhost:8010 — no build step, no node.
✨ Highlights
- 🖥️ Research Studio SPA — Dashboard with live stats & quick actions, Library, Chat, Podcast studio, OCR, Citations, Settings and Log viewer in one sidebar
- 💬 Chat with project scope — pick a project, watch thread history and RAG context follow it; answers carry page-level citations
- 🎙️ Podcast studio v2 — async generation with live job cards, project-scoped paper picking, waveform player
- 🔍 OCR studio — PDFs & images → clean Markdown (Tesseract / PaddleOCR-VL / TeleOCR backends)
- 📝 Citations — Crossref verification, APA 7 / Vancouver export
- ⌨️ Command palette —
Ctrl/Cmd + K,Enterruns,Esccloses - 📎 Supported documents: PDF · DOCX/DOC · TXT · Markdown (library) · PDF + PNG/JPEG/WEBP/BMP/TIFF → Markdown (OCR studio)
- 🚀 Background launchers —
run.bat/stop_all.bat(also as root-level shims); hiddenpythonwserver, browser auto-open; port-aware Exit & shut down buttons
▶ Run it
pip install -r requirements.txt
copy .env.example .env # paste any OpenAI-compatible key, or point at LM Studio / Ollama
run.bat # → http://localhost:8010
🎨 Try the UI online (static demo, no backend)
farazjz.github.io/Commentarium
🆚 v1.9 vs v2.0
| v1.9.0 (Streamlit) | v2.0.0 (Research Studio) | |
|---|---|---|
| UI | Streamlit pages | Single-page app served by FastAPI |
| Startup | API + UI processes | One process, background launcher |
| URL | :8501 |
:8010 |
| Backend | identical feature set | identical feature set |
Full browser test suite: ALL PASS at release time.