run-llama/semtools

Health v2 · maintenance only

Adoption not part of the score

1858 stars · 142 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

SemTools is a Rust command-line toolkit for parsing documents (PDF, DOCX, PPTX, etc.) into markdown via LlamaParse and running fast local semantic search over text using multilingual model2vec embeddings with cosine similarity. It also ships an 'ask' command, an AI agent with search/read tools for answering questions over document collections via OpenAI-compatible APIs, plus workspace management for large collections.

Use cases

• parse pdfs and docx files to markdown from the command line
• run semantic search over local text files
• search documents by meaning instead of exact keywords like grep
• ask an LLM questions about a folder of documents
• bulk convert presentations and documents into markdown
• pipe parsed documents into search or an agent with unix tools
• set up local retrieval over a large document collection

When to choose

• you want a fast, Unix-friendly CLI for document parsing and semantic search without running a server
• you need local semantic search using embeddings while keeping parsing delegated to LlamaParse
• you want to build quick RAG-style question answering over local document collections
• you already use the LlamaIndex/LlamaParse ecosystem and want terminal tooling

When to avoid

• you need fully offline parsing, since the default parse backend requires a LlamaParse API key
• you need a GUI, a hosted search service, or a web interface rather than a command-line tool
• you only need exact keyword matching, where grep is sufficient
• you cannot use OpenAI or an OpenAI-compatible API, since the ask command depends on it

Facets

cli-tool · maturity active

search-engine parser pdf rag agent-framework cli artificial-intelligence files pdf developer-tools cross-platform cli windows rust semantic-search embeddings document-parsing model2vec llamaparse llamaindex multilingual-embeddings unix-tools document-qa markdown-conversion search natural-language-processing command-line linux macos

Member repositories

For agents

markdown · JSON · MCP: product_card(name="run-llama/semtools")