Practical overview
When it fits
Use it as a starting point when you want a Python command-line workflow for document Q&A with a quantized model on CPU rather than a hosted inference service.
Who it is for
- Developers building local document question-answering workflows.
- Teams exploring self-managed CPU inference for queries over internal or organizational documents.
Documented uses
- Ask natural-language questions about an ingested document collection.
- Create a FAISS vector store from a dataset using the documented ingestion script.
- Adapt the example annual-report workflow to an organization’s own documents.
Requirements & limits
The public GitHub repository specifies an MIT license. The documented application is self-hosted and command-line based.
- The example requires a GGML model binary in the
models/directory. - The documented stack includes Python, C Transformers, GGML, LangChain, FAISS, Sentence-Transformers and Poetry.
- The repository provides separate scripts for creating the vector store and submitting a query.
- Using a different quantized model is described broadly, but individual alternatives are not documented or tested.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Run a command-line question against the included document workflow
Pass a document question to the application using the documented command-line entry point.
Before you start
- The project files and Python dependencies.
- A GGML model binary downloaded from the linked Llama 2 model location and placed in the
models/folder. - Poetry for the README’s example command; the README says to omit
poetry runif not using Poetry.
Steps
Place the downloaded GGML model binary in
models/.Open a terminal in the project directory.
Run
poetry run python main.py "", or omitpoetry runif not using Poetry.
Expected outcome
The application accepts a user question through `main.py` for document Q&A.
Guide limitations
- The README documents a sample dataset and query, but does not establish support for other document formats.
- The README does not specify hardware performance or response-time expectations.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 16 October 2026
- Original website title
- kennethleungty/Llama-2-Open-Source-LLM-CPU-Inference · Official homepage title · retained in its source language

