How lucifer516-sudoer/revolvo_api_deprecated works
Revolvo is a legacy backend for asking LLMs questions about PDF books, with a separate watched-folder ingestion workflow and a Streamlit proof of concept. In the documented runtime path, FastAPI serves book records and streamed PDF answers; the answer handler prepares a book’s documents and constructs a chat API with an LLM and Chroma store. The watcher also sends new PDFs to the document maker. Several source modules are only indexed, not excerpted, so their internal behavior and unshown links are intentionally omitted.
Main entry points: main.py FastAPI service · maker.py Document maker · _db.py Batched embedding loader · registry.py Book registry
Components 19
User interfaces
- FastAPI service
revolvo_api/main.py - Chat API
revolvo_api/api.py - Streamlit POC
revolvo_api/ui_v2.py - Embedder helper
revolvo_api/helper_funcs.py
PDF ingestion
- PDF watcher
revolvo_api/automation/observe_and_react.py - PDF folder
- Document maker
revolvo_api/automation/maker.py - PDF processor
revolvo_api/processor/from_pdf.py
Retrieval and storage
- Embedding manager
revolvo_api/embed/manager.py - Batched embedding loader
revolvo_api/db/_db.py - Chroma vector store
- Ollama chat model
Records and logging
- Book registry
revolvo_api/automation/registry.py - CSV data access
revolvo_api/db/csv_db/_csv_db.py - PDF record model
revolvo_api/db/csv_db/_models.py - Books CSV
- Logger configuration
revolvo_api/utils/logging/logger.py - Rich log handlers
revolvo_api/utils/logging/_custom_handler.py
Other components
- User
Connections 18
- User → FastAPI service: requests
README.md - FastAPI service → Book registry: reads records
revolvo_api/main.py - FastAPI service → Document maker: adds documents
revolvo_api/main.py - FastAPI service → Chat API: creates and queries
revolvo_api/main.py - FastAPI service → Ollama chat model: configures model
revolvo_api/main.py - FastAPI service → Chroma vector store: configures store
revolvo_api/main.py - User → Streamlit POC: uses POC
README.md - Streamlit POC → Embedder helper: uses embedder
revolvo_api/ui_v2.py - PDF folder → PDF watcher: notifies of PDFs
revolvo_api/automation/observe_and_react.py - PDF watcher → Document maker: submits PDF
revolvo_api/automation/observe_and_react.py - Document maker → PDF processor: loads and splits
revolvo_api/automation/maker.py - Document maker → Batched embedding loader: adds documents
revolvo_api/automation/maker.py - Batched embedding loader → Embedding manager: gets embedder
revolvo_api/db/_db.py - Batched embedding loader → Chroma vector store: writes embeddings
revolvo_api/db/_db.py - Book registry → CSV data access: reads and writes
revolvo_api/automation/registry.py - Book registry → PDF record model: constructs records
revolvo_api/automation/registry.py - CSV data access → Books CSV: reads and writes
revolvo_api/db/csv_db/_csv_db.py - Logger configuration → Rich log handlers: configures handlers
revolvo_api/utils/logging/logger.py