Setup
Pré-requisitos
O que você precisa instalado antes de rodar o LocalLens.
O LocalLens roda em Bun e usa alguns módulos node:* onde
precisa.
Obrigatório
- Bun
>=1.3.0— runtime, test runner, bundler. - Node
>=22.17.0— usado pelo TypeScript e algumas APIsnode:. - QVAC SDK — instalado automaticamente
pelo
bun install. Os pesos dos modelos baixam no primeiro uso.
Recomendado
- Uma máquina que consiga rodar um modelo quantizado de 1.7B de parâmetros. Se não conseguir, o LocalLens cai para a variante de 600M na primeira vez que tentar carregar o modelo de chat.
- Algumas centenas de megabytes de disco livre para o cache de modelos do QVAC e os embeddings dos seus brains.
Sem chaves de API
O LocalLens não chama nenhum serviço hospedado. Sem chave da OpenAI, sem chave da Tether, nada parecido. O único tráfego de rede é o download inicial dos modelos, que o Bun faz cache.
Onde tudo mora
| Caminho | O que tem ali |
|---|---|
~/.cache/qvac/ (ou equivalente da plataforma) | Pesos dos modelos baixados |
<repo>/.locallens/store.json | Registro dos brains e chunks |
| Diretório de workspace QVAC | Índices de embedding, um por brain |
As próximas páginas passam por: