Repolode
Enviar
IceWhaleTech

IceWhaleTech/filens

Visor de código abierto que funciona en el navegador y Agent CLI para leer, buscar, aplicar OCR y previsualizar más de 300 formatos, como Office, iWork, PDF, CAD y 3D.

Ver en GitHubSitio web
Estrellas
199
Forks
8
Issues abiertos
0
Último commit
anteayer

¿Qué es?

filens es un proyecto con dos partes. Agent CLI, desarrollado en Rust, lee PDF, documentos de Office, hojas de cálculo, escaneos e imágenes en el equipo local; busca en directorios y archivos comprimidos anidados; extrae pasajes clave con coordenadas de página; encuentra archivos duplicados e imágenes similares; y genera resultados en texto, JSON, Markdown, CSV y otros formatos. La instalación incluye OCR mediante RapidOCR, y también hay una variante Lite que permite añadir OCR más adelante.

La segunda parte es una biblioteca de previsualización íntegramente frontend, distribuida como el paquete npm filens-preview y como componente de Vue. Muestra en el navegador archivos de Office, iWork (Keynote, Pages, Numbers), PDF, CAD (DXF, STEP), mallas 3D, fotos RAW, panorámicas de 360°, archivos comprimidos y libros electrónicos mediante WebAssembly, sin subir archivos ni usar un servidor de conversión. Se distribuye en módulos independientes o como un único archivo JS, y también permite exportar HTML sin conexión mediante CLI.

La fidelidad y las limitaciones varían según el formato, y el proyecto las documenta en una tabla de compatibilidad. En las previsualizaciones de archivos de Office antiguos se eliminan las macros, y las previsualizaciones de STEP no incluyen los colores originales ni los árboles de ensamblaje.

Funciones clave

  • 01Lee y busca localmente PDF, archivos de Office, hojas de cálculo, escaneos e imágenes desde la línea de comandos.
  • 02Busca en archivos comprimidos anidados y extrae pasajes originales clave sin usar un modelo.
  • 03Encuentra archivos duplicados e imágenes similares.
  • 04Exporta resultados en texto, JSON, Markdown, HTML, CSV, YAML o XML.
  • 05Previsualiza archivos de Office, iWork, PDF, CAD, 3D, RAW y 360° en el navegador, sin servidor.
  • 06Ofrece un paquete npm, un componente de Vue y una exportación HTML sin conexión en un solo archivo.

Casos de uso

  • Proporcionar a un AI Agent el texto fuente, los resultados de búsqueda y los pasajes citados de documentos locales.
  • Incorporar previsualizaciones de documentos, CAD o 3D en una aplicación web sin un backend de conversión.
  • Previsualizar archivos de Keynote, Pages o Numbers en plataformas sin aplicaciones de Apple.
  • Encontrar archivos duplicados y fotos similares en un árbol de directorios.

Inicio rápido

  1. 1

    Instala Full CLI globalmente con npm

    npm install -g filens-cli
  2. 2

    Lee un PDF como JSON

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

    Crea una vista previa de un archivo en el navegador y sin conexión

    filens preview report.pdf

Antes de usarlo

  • La ejecución nativa en Windows y Linux aún está pendiente de validación.
  • Las solicitudes en lenguaje natural solo reconocen un conjunto limitado de intenciones.
  • Full CLI incluye modelos de OCR, por lo que el tamaño de la instalación es de unos 31 MiB.

En colecciones

Bibliotecas de skills para agentes de IAHerramientas de CLI y terminalHerramientas de PDF, OCR y documentos

Temas

#file-preview#ocr#document-parsing#webassembly#rust#cli#pdf#office#3d-viewer#agent-skills

Preguntas frecuentes

¿Qué es filens?
Visor de código abierto que funciona en el navegador y Agent CLI para leer, buscar, aplicar OCR y previsualizar más de 300 formatos, como Office, iWork, PDF, CAD y 3D. filens es un proyecto con dos partes. Agent CLI, desarrollado en Rust, lee PDF, documentos de Office, hojas de cálculo, escaneos e imágenes en el equipo local; busca en directorios y archivos comprimidos anidados; extrae pasajes clave con coordenadas de página; encuentra archivos duplicados e imágenes similares; y genera resultados en texto, JSON, Markdown, CSV y otros formatos. La instalación incluye OCR mediante RapidOCR, y también hay una variante Lite que permite añadir OCR más adelante.
¿filens es gratuito? ¿Qué licencia tiene?
filens es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿filens sigue mantenido?
Mantenimiento activo. El último commit de filens fue el 5 nov 2026.
¿Para qué puedo usar filens?
Proporcionar a un AI Agent el texto fuente, los resultados de búsqueda y los pasajes citados de documentos locales. Incorporar previsualizaciones de documentos, CAD o 3D en una aplicación web sin un backend de conversión. Previsualizar archivos de Keynote, Pages o Numbers en plataformas sin aplicaciones de Apple. Encontrar archivos duplicados y fotos similares en un árbol de directorios.
¿Cómo se instala filens?
Instala Full CLI globalmente con npm: npm install -g filens-cli Lee un PDF como JSON: filens 'read "report.pdf" as json' Crea una vista previa de un archivo en el navegador y sin conexión: filens preview report.pdf
¿Dónde consigo filens?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/IceWhaleTech/filens

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados