Getting Started

Requires Python 3.9+ (the docs, qmd, llamaindex, and langchain extras — plus the built-in gnosis-mcp server — need 3.10+).

pip install gnosis-markdown

First command

# One page → one markdown file (written to ./ by default)
gnosis https://docs.python.org/3/tutorial/

# Crawl an entire section
gnosis https://docs.python.org/3/tutorial/ --all -o ./python-docs/

Optional extras

pip install gnosis-markdown[qmd]     # QMD vector-DB indexing
pip install gnosis-markdown[docs]    # document conversion (MarkItDown)

Verify it yourself

gnosis https://docs.python.org/3/tutorial/ -o out/ --warc
shasum -a 256 out/.gnosis-store/<bytes_sha256>   # matches the hash in the .md

The other CLIs

gnosis-bench --urls urls.txt         # reproducible scorecard (one URL per line)
gnosis-doc report.pdf -o report.md   # document → Markdown