# LYiHub/mad-professor-public

An AI companion for reading papers.

Repository: https://github.com/LYiHub/mad-professor-public
Canonical: https://ross.abutalabs.com/products/mad-professor-public
Language: JavaScript
License: Apache-2.0
License Family: permissive
Last push: 2025-04-18T11:38:09+00:00

## Health v2 (maintenance only)
Score: 27/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 17, release rhythm 35, longevity 35
- inputs: {"age_days": 502, "days_push": 502, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1604, forks 196 (observed 2026-08-28T04:05:10.282939+00:00)

## What it is
A desktop AI companion application for reading academic papers, built with PyQt6. It combines PDF parsing and translation, RAG-based retrieval, LLM-powered Q&A with a customizable 'grumpy professor' persona, and voice interaction (speech recognition and TTS).

## Use cases
- read academic papers with AI assistance
- translate papers into bilingual side-by-side view
- ask questions about a paper's content and get grounded answers
- convert PDFs to structured markdown
- listen to AI answers read aloud via TTS
- ask questions by voice instead of typing

## When to choose
- you want a local desktop app for interactive paper reading with RAG
- you have a CUDA GPU with 6GB+ VRAM and want offline PDF parsing and speech recognition
- you want a fun, persona-driven AI reading companion with bilingual display

## When to avoid
- you need a lightweight tool without GPU requirements
- you don't want to depend on external APIs like DeepSeek and MiniMax
- you need a web-based or collaborative paper reading tool
- you're on macOS or mobile

## Facets
- artifact type: application
- maturity: active
- function: rag, pdf, ocr, speech-recognition, tts, llm-inference, chatbot, nlp, gui
- domain: artificial-intelligence, large-language-models, pdf, education
- platform: windows, python
- tags: paper-reading, academic-research, ai-companion, bilingual-translation, pyqt6, voice-interaction, personality-assistant, retrieval-augmented-generation, natural-language-processing, linux, desktop, gpu

## Member repositories
- LYiHub/mad-professor-public (main) score 27

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:10.282939+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:52:18.607175+00:00, confidence not recorded.
  - readme: https://github.com/LYiHub/mad-professor-public (fetched 2026-08-28T04:05:10.282939+00:00, sha a81b0da0ac28)
- Data as of 2026-08-30T08:39:29.467469+00:00.