fs-explorer

CLI agent that helps you explore a directory and its content (it can also read PDF/PPTX/DOCX/XLSX files!).

Installation and Usage

Clone this repository:

git clone https://github.com/run-llama/fs-explorer
cd fs-explorer

Install locally:

uv pip install .

Export a Google API key (must have access to EAP models):

export GOOGLE_API_KEY="..."

Run:

explore run --task "Within the data/ directory, can you help e find the PDF file that contains an order or a complaint, and, once you found them, ask me which one I would like you to summarize"

Evaluation against traditional RAG

In the packages directory we have two packages:

• rag-starterkit: a traditional RAG application implementing hybrid search. (More in the dedicated README).
• eval-framework: a simple evaluation framework that produces LLM-as-a-judge-based evals along with collecting time-, tool usage- and file-search-based statistics. Find out how to run the evaluation and collect statistics in the dedicated README.
• cache-arxiv: a utility package to cache arXiv papers for larger scale experiments.

Find the evaluation guide here.