Skip to content

vera

vera publishes the vera console command and the vera_cli Python package. It depends on vera-doc, vera-ingest, vera-ingest-pymupdf, and vera-embed-openai, and owns argument parsing, human and JSON output, exit codes, and retrieval evaluation. The optional docling extra installs vera-ingest-docling for --parser docling (PDF plus search-only DOCX/PPTX/XLSX/HTML).

The distribution was previously named vera-cli on PyPI. pip install vera-cli remains a compatibility alias. The Python import is still vera_cli; the source tree lives in packages/vera-cli.

Use the CLI for complete document workflows rather than assembling the Python packages directly.

Install

From PyPI:

python -m pip install "vera>=0.3.2"
python -m pip install "vera[docling]>=0.3.2"

From a repository checkout:

python -m pip install \
  ./packages/vera-doc \
  ./packages/vera-ingest \
  ./packages/vera-ingest-pymupdf \
  ./packages/vera-embed-openai \
  ./packages/vera-cli

Verify the entry point:

vera --help

Start here

vera convert "manual.pdf" "manual.vera"
vera validate "manual.vera"
vera search "manual.vera" "detention requirements" --top-k 5 --json
vera search "manual.vera" "detention requirements" --context-chunks 1 --pretty
vera get "manual.vera" "chunk_0042" --json
vera figures "manual.vera" --out-dir "./figures" --json

All one-shot commands support --json. Search also supports the mutually exclusive --pretty presentation mode. vera mcp is a long-running stdio server and is the exception.

Documentation

Reference