IceWhaleTech/filens

O que é?

Recursos principais

• 01Lê e pesquisa PDFs, arquivos do Office, planilhas, digitalizações e imagens localmente pela linha de comando.
• 02Pesquisa arquivos compactados aninhados e extrai trechos originais importantes sem usar um modelo.
• 03Encontra arquivos duplicados e imagens semelhantes.
• 04Exporta os resultados como texto, JSON, Markdown, HTML, CSV, YAML ou XML.
• 05Pré-visualiza arquivos Office, iWork, PDF, CAD, 3D, RAW e 360° no navegador, sem servidor.
• 06Oferece um pacote npm, um componente Vue e exportação offline para um único arquivo HTML.

Casos de uso

• Fornecer a um AI Agent o texto de origem, os resultados de pesquisa e trechos citados de documentos locais.
• Incorporar pré-visualizações de documentos, CAD ou 3D em uma aplicação web sem backend de conversão.
• Pré-visualizar arquivos Keynote, Pages ou Numbers em plataformas sem aplicativos da Apple.
• Encontrar arquivos duplicados e fotos semelhantes em uma árvore de diretórios.

Início rápido

1. 1

   Instale o Full CLI globalmente com npm

   npm install -g filens-cli
2. 2

   Leia um PDF como JSON

   filens 'read "report.pdf" as json'
3. 3

   Crie uma pré-visualização offline de um arquivo no navegador

   filens preview report.pdf

Antes de usar

• !A execução nativa no Windows e no Linux ainda está pendente de validação.
• !Solicitações em linguagem natural reconhecem apenas um conjunto limitado de intenções.
• !O Full CLI inclui modelos de OCR, então o tamanho da instalação é de cerca de 31 MiB.

Em coleções

Tópicos

Perguntas frequentes

O que é filens?

Visualizador local no navegador e Agent CLI open source para ler, pesquisar, aplicar OCR e pré-visualizar mais de 300 formatos de arquivo, incluindo Office, iWork, PDF, CAD e 3D. filens é um projeto com duas partes. O Agent CLI, desenvolvido em Rust, lê PDFs, documentos do Office, planilhas, digitalizações e imagens na máquina local, pesquisa diretórios e arquivos compactados aninhados, extrai trechos importantes com coordenadas de página, encontra arquivos duplicados e imagens semelhantes e gera resultados em texto, JSON, Markdown, CSV e outros formatos. A instalação inclui OCR via RapidOCR; a variante Lite permite adicionar OCR posteriormente.

filens é gratuito? Qual é a licença?

filens é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.

filens ainda é mantido?

Manutenção ativa. O último commit de filens foi em 5 de nov. de 2026.

Para que posso usar filens?

Fornecer a um AI Agent o texto de origem, os resultados de pesquisa e trechos citados de documentos locais. Incorporar pré-visualizações de documentos, CAD ou 3D em uma aplicação web sem backend de conversão. Pré-visualizar arquivos Keynote, Pages ou Numbers em plataformas sem aplicativos da Apple. Encontrar arquivos duplicados e fotos semelhantes em uma árvore de diretórios.

Como instalar filens?

Instale o Full CLI globalmente com npm: npm install -g filens-cli Leia um PDF como JSON: filens 'read "report.pdf" as json' Crie uma pré-visualização offline de um arquivo no navegador: filens preview report.pdf

Onde consigo filens?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/IceWhaleTech/filens