Skip to content

Releases

Commentarium v2.0 — Research Studio

Commentarium v2.0 — Research Studio Latest
Latest

Choose a tag to compare

View all tags
@Farazjz Farazjz released this 17 Oct 02:52
v2.0.0
263bf47

🧬 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, Enter runs, Esc closes
  • 📎 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); hidden pythonw server, 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.

Assets 2
Loading

Commentarium v1.9

Commentarium v1.9

Choose a tag to compare

View all tags
@Farazjz Farazjz released this 17 Oct 01:40
v1.9.0
0c7fa64

RELEASE-NOTES-v1.9.0.md

Commentarium v1.9 — Phases 1–9 complete

Final release of the Streamlit-era UI — the end of the v1.x line. Development continues on the
v2.0 branch ("Research Studio UI"), to be released as v2.0.0.

Highlights (Phases 1–9)

  • Phase 1 — Foundation: project skeleton, .env config, logging system (rotating file + console
    • in-app), FastAPI backend, custom NumPy + SQLite vector store with persistence.
  • Phase 2 — Ingestion: PDF/DOCX parsers (PyMuPDF / python-docx), OCR of scanned pages, smart
    chunking with page + section metadata, local & OpenAI-compatible embeddings, full project /
    document management.
  • Phase 3 — Chat + RAG: cosine retrieval, grounded answers with strict source tags, SQLite chat
    history, working Chat page.
  • Phase 4 — Citations: Crossref metadata lookup with confidence ranking, verification workflow,
    APA 7 + Vancouver formatters, source-tag resolution into real in-text citations + bibliography.
  • Phase 5 — Polish: embedding-dimension consistency guard (fails loudly, by design), corpus model
    identity tracking, stale-artifact cleanup, README QA/troubleshooting.
  • Phase 6 — Management + retrieval fixes: project/chat management with cleanup, professional
    project cards + document actions, section-weighted retrieval (Reference chunks no longer crowd out
    real content), distributed retrieval with auto-detect heuristics.
  • Phase 7 — Exit / shutdown: graceful one-click shutdown of API + UI servers via psutil.
  • Phase 8 — Research workflow + podcast studio: multi-kind per-document summaries (Brief /
    Detailed / Key points / TL;DR / Quiz, cached), per-project model & temperature overrides, tags
    & notes, NotebookLM-style podcast deep-dives with edge-tts, local VoiceStudio (voice
    cloning, en/fa), or any OpenAI-compatible /v1/audio/speech server.
  • Phase 9 — One-click launcher + OCR to Markdown: single run.bat (starts API + UI hidden,
    waits for the port, opens the browser) plus a stand-alone OCR page (PaddleOCR-VL-1.6 / TeleOCR
    vision-language backends, live Markdown preview, downloads, saved-file history).

Running

pip install -r requirements.txt
copy .env.example .env   # add your OpenAI-compatible key (or point at a local server)
run.bat                  # opens http://localhost:8501

See the README for full setup, model options (OpenRouter / LM Studio / Ollama / vLLM / LiteLLM),
podcast voices, and OCR backends.

What's next

v2.0.0 — the "Research Studio" UI: a modern dark/light single-page app served by the same FastAPI
backend (Streamlit stays available as a legacy fallback).

Loading