O que o LocalLens faz
Crie um brain a partir de uma pasta local e faça perguntas embasadas sobre o conteúdo dela.
Escolha uma pasta. O LocalLens transforma ela em um brain — um índice com o qual você pode conversar. Faça uma pergunta, receba uma resposta e veja exatamente quais chunks de quais arquivos o modelo usou como base.
Você pode usar de duas formas:
- a CLI, quando você só quer apontar para uma pasta, fazer uma pergunta e sair;
- a UI do navegador (servida por
Bun.serve), quando você está malabarismo com vários brains e quer fazer follow-ups em uma thread de chat de verdade.
Ambos passam pela mesma classe LocalLensApp, então qualquer coisa que cai em
um normalmente já aparece no outro sem encanamento extra.
O fluxo em quatro passos
- Escolha uma pasta. Passe um caminho para a CLI ou clique em Choose folder na UI do navegador.
- Indexe. O LocalLens percorre a pasta, mantém os arquivos de texto, faz o chunking e escreve os chunks em um workspace QVAC RAG como embeddings.
- Pergunte algo. A pergunta é embedada e comparada contra o workspace. Os top hits viram trechos numerados no prompt.
- Leia a resposta. O modelo de chat faz stream de uma resposta que cita
trechos como
[1],[2], e a UI lista essas citações como links de volta para os arquivos originais.
Onde os dados ficam
Brains e chunks ficam em .locallens/store.json. Embeddings ficam no diretório
de workspace do próprio QVAC. Apague um brain e os dois vão junto em
um passo só.
Onde o código mora
| Arquivo | O que ele possui |
|---|---|
src/cli.ts | O caminho sem UI. Uma pasta, uma pergunta, uma resposta, depois cleanup. |
src/server.ts | Servidor HTTP Bun opcional que sustenta a UI do navegador. |
src/ui/ | A UI estática do navegador: index.html, app.js, styles.css. |
examples/sample-brain/ | Uma pasta de demo para a CLI e a UI mastigarem. |
Se você quer o mapa mais profundo, as páginas arquitetura e estrutura do código fazem esse trabalho.
Como isso aparece
Uma execução da CLI:
$ bun run cli examples/sample-brain "Why does LocalLens use QWEN3_1_7B_INST_Q4?"
LocalLens uses QWEN3_1_7B_INST_Q4 because it offers a strong balance of answer
quality and local resource use [1]. A 600M fallback is wired in for slimmer
machines [2].
Sources:
- locallens.md#0
- qvac-notes.md#1A UI do navegador mostra a mesma resposta renderizada como Markdown, com cada
[1] e [2] linkados ao chunk de onde vieram.