Qué hace LocalLens
Crea un cerebro a partir de una carpeta local y haz preguntas fundamentadas sobre su contenido.
Elige una carpeta. LocalLens la convierte en un cerebro — un índice con el que puedes chatear. Haz una pregunta, recibe una respuesta y ve exactamente en qué chunks de qué archivos se apoyó el modelo.
Puedes manejarlo de dos formas:
- la CLI, cuando solo quieres apuntar a una carpeta, hacer una pregunta y salir;
- la UI del navegador (servida por
Bun.serve), cuando estás manejando varios cerebros y quieres preguntas de seguimiento en un hilo de chat real.
Ambas pasan por la misma clase LocalLensApp, así que lo que cae en
una suele iluminar la otra sin plomería extra.
El flujo de cuatro pasos
- Elige una carpeta. Pasa una ruta a la CLI, o haz clic en Choose folder en la UI del navegador.
- Indéxala. LocalLens recorre la carpeta, se queda con los archivos con forma de texto, los corta en chunks y los escribe en un workspace RAG de QVAC como embeddings.
- Pregunta algo. La pregunta se embeddea y se compara contra el workspace. Los mejores hits se vuelven extractos numerados en el prompt.
- Lee la respuesta. El modelo de chat hace stream de una
respuesta que cita extractos como
[1],[2], y la UI lista esas citas como enlaces de vuelta a los archivos originales.
Dónde viven los datos
Los cerebros y chunks aterrizan en .locallens/store.json. Los
embeddings se quedan en el directorio de workspace propio de QVAC.
Borra un cerebro y ambos se van con él en un solo paso.
Dónde vive el código
| Archivo | Qué posee |
|---|---|
src/cli.ts | El camino sin UI. Una carpeta, una pregunta, una respuesta y luego limpieza. |
src/server.ts | Servidor HTTP opcional de Bun que respalda la UI del navegador. |
src/ui/ | La UI estática del navegador: index.html, app.js, styles.css. |
examples/sample-brain/ | Una carpeta demo para que la CLI y la UI la mastiquen. |
Si quieres el mapa más profundo, las páginas de arquitectura y estructura del código hacen ese trabajo.
Cómo se ve esto
Un run de la 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#1La UI del navegador muestra la misma respuesta renderizada como
Markdown, con cada [1] y [2] enlazado al chunk del que provino.