git404hub

what is lumen fr?

coder1397924/lumen — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · general

tl;dr

A Windows desktop app for chatting privately with your own PDF documents, with answers cited by file name and page number.

vibe map

mindmap
  root((repo))
    What it does
      Chat with PDF documents
      Cites file and page
      Local or cloud mode
    Tech stack
      Python
      CustomTkinter
      LangChain
      ChromaDB
    Features
      Incremental file loading
      Granular file deletion
      Local embedding model
    Distribution
      Windows executable
      Run from source
    Audience
      Privacy focused users
      Researchers with document sets

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Ask questions across several PDF documents at once and get cited answers.

VIBE 2

Search private or sensitive PDFs locally without sending data to the cloud.

VIBE 3

Add or remove individual PDF files from an active session without starting over.

VIBE 4

Package the app into a single standalone Windows executable to share with others.

what's the stack?

PythonCustomTkinterLangChainChromaDB

how it stacks up fr

coder1397924/lumen0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultymoderatemoderate
Complexity2/54/5
Audiencegeneralgeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

in plain english

Lumen is a desktop app for Windows that lets you chat with your own PDF documents and get answers pulled directly from them, instead of searching through the files by hand. You can load several PDFs into a session at once, add more files one at a time without losing what you already loaded, and remove individual files from a checklist in the sidebar whenever you want. When Lumen answers a question, it tells you exactly which file and page number the answer came from, so you can check the source yourself. The app can run in two modes: an online mode that uses a cloud based AI service, and an offline mode that keeps everything on your own computer. In offline mode, the system that turns your documents into searchable data runs locally using a small model called all-MiniLM-L6-v2, so your files and their contents never have to leave your PC. This approach is known as retrieval augmented generation, a technique where the AI looks up relevant pieces of your documents before answering, rather than relying only on what it already knows. For Windows users who do not want to set up Python, the project offers a ready made executable file you can download from the Releases page and run immediately. For anyone who wants to run it from source, the README walks through cloning the repository, creating a Python virtual environment, installing the required packages, and adding an API key to a configuration file if you want to use the online mode. The README also shows how to package the app into a single standalone Windows executable using a tool called PyInstaller. The interface is built with CustomTkinter, a library for building desktop windows and menus, and the document search backend uses LangChain along with a local database called ChromaDB to store and search the document data. The README does not state a license for this project.

prompts (copy fr)

prompt 1
Walk me through setting up Lumen locally including the Python virtual environment steps.
prompt 2
Explain the difference between Lumen's online and offline modes and when to use each.
prompt 3
Show me how Lumen cites the file name and page number for its answers.
prompt 4
How do I package this app into a standalone Windows executable using PyInstaller.

Frequently asked questions

what is lumen fr?

A Windows desktop app for chatting privately with your own PDF documents, with answers cited by file name and page number.

What language is lumen written in?

Mainly Python. The stack also includes Python, CustomTkinter, LangChain.

Who is lumen for?

Mainly general.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.