Office, PDF, CAD, 3D, 미디어, 압축 파일 등 다양한 형식의 온라인 미리보기를 제공하는 자체 호스팅 Spring Boot 서비스입니다.
IceWhaleTech/filens
Office, iWork, PDF, CAD, 3D 등 300개 이상의 파일 형식을 읽고 검색하며 OCR 처리와 미리보기를 제공하는 오픈 소스 브라우저 로컬 뷰어 및 Agent CLI입니다.
- 스타
- 199
- 포크
- 8
- 열린 이슈
- 0
- 마지막 커밋
- 그저께
어떤 프로젝트인가요?
filens는 두 부분으로 구성된 프로젝트입니다. Rust로 만든 Agent CLI는 로컬 컴퓨터에서 PDF, Office 문서, 스프레드시트, 스캔 문서와 이미지를 읽고, 디렉터리와 중첩된 아카이브를 검색하며, 페이지 좌표와 함께 주요 구절을 추출하고, 중복 파일과 유사한 이미지를 찾아 텍스트, JSON, Markdown, CSV 등의 형식으로 출력합니다. 설치본에는 RapidOCR을 통한 OCR이 포함되며, OCR을 나중에 추가하는 Lite 버전도 있습니다.
두 번째 부분은 순수 프론트엔드 미리보기 라이브러리로, npm 패키지 filens-preview와 Vue 컴포넌트로 배포됩니다. WebAssembly를 사용해 업로드나 변환 서버 없이 브라우저에서 Office, iWork(Keynote, Pages, Numbers), PDF, CAD(DXF, STEP), 3D 메시, RAW 사진, 360° 파노라마, 아카이브와 전자책을 렌더링합니다. 분할 모듈 또는 단일 JS 파일 형태로 제공되며, CLI를 통한 오프라인 HTML 내보내기도 지원합니다.
형식별로 재현 수준과 제한 사항이 다르며, 프로젝트 문서의 지원 매트릭스에서 이를 확인할 수 있습니다. 구형 Office 파일 미리보기에서는 매크로가 제거되며, STEP 미리보기에는 원본 색상과 어셈블리 트리가 표시되지 않습니다.
핵심 기능
- 01명령줄에서 PDF, Office 파일, 스프레드시트, 스캔 문서와 이미지를 로컬에서 읽고 검색합니다.
- 02중첩된 아카이브를 검색하고 모델 없이 원문의 주요 구절을 추출합니다.
- 03중복 파일과 유사한 이미지를 찾습니다.
- 04텍스트, JSON, Markdown, HTML, CSV, YAML 또는 XML 형식으로 결과를 내보냅니다.
- 05서버 없이 브라우저에서 Office, iWork, PDF, CAD, 3D, RAW 및 360° 파일을 미리 봅니다.
- 06npm 패키지, Vue 컴포넌트, 오프라인 단일 파일 HTML 내보내기를 제공합니다.
활용 사례
- 로컬 문서에서 추출한 원문, 검색 결과와 출처가 표시된 구절을 AI Agent에 제공합니다.
- 변환 백엔드 없이 웹 애플리케이션에 문서, CAD 또는 3D 미리보기를 삽입합니다.
- Apple 앱이 없는 플랫폼에서 Keynote, Pages 또는 Numbers 파일을 미리 봅니다.
- 폴더 트리 전체에서 중복 파일과 유사한 사진을 찾습니다.
빠른 시작
- 1
npm으로 Full CLI를 전역 설치합니다
npm install -g filens-cli - 2
PDF를 JSON으로 읽습니다
filens 'read "report.pdf" as json' - 3
파일의 오프라인 브라우저 미리보기를 만듭니다
filens preview report.pdf
사용 전 알아둘 점
- Windows 및 Linux에서의 네이티브 실행은 아직 검증이 진행 중입니다.
- 자연어 요청은 제한된 범위의 인텐트만 인식합니다.
- Full CLI에는 OCR 모델이 포함되어 있어 설치 크기가 약 31 MiB입니다.
포함된 컬렉션
토픽
자주 묻는 질문
- filens은(는) 무엇인가요?
- Office, iWork, PDF, CAD, 3D 등 300개 이상의 파일 형식을 읽고 검색하며 OCR 처리와 미리보기를 제공하는 오픈 소스 브라우저 로컬 뷰어 및 Agent CLI입니다. filens는 두 부분으로 구성된 프로젝트입니다. Rust로 만든 Agent CLI는 로컬 컴퓨터에서 PDF, Office 문서, 스프레드시트, 스캔 문서와 이미지를 읽고, 디렉터리와 중첩된 아카이브를 검색하며, 페이지 좌표와 함께 주요 구절을 추출하고, 중복 파일과 유사한 이미지를 찾아 텍스트, JSON, Markdown, CSV 등의 형식으로 출력합니다. 설치본에는 RapidOCR을 통한 OCR이 포함되며, OCR을 나중에 추가하는 Lite 버전도 있습니다.
- filens은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- filens은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- filens은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. filens의 마지막 커밋은 2026년 11월 5일입니다.
- filens은(는) 어디에 사용할 수 있나요?
- 로컬 문서에서 추출한 원문, 검색 결과와 출처가 표시된 구절을 AI Agent에 제공합니다. 변환 백엔드 없이 웹 애플리케이션에 문서, CAD 또는 3D 미리보기를 삽입합니다. Apple 앱이 없는 플랫폼에서 Keynote, Pages 또는 Numbers 파일을 미리 봅니다. 폴더 트리 전체에서 중복 파일과 유사한 사진을 찾습니다.
- filens는 어떻게 설치하나요?
- npm으로 Full CLI를 전역 설치합니다: npm install -g filens-cli PDF를 JSON으로 읽습니다: filens 'read "report.pdf" as json' 파일의 오프라인 브라우저 미리보기를 만듭니다: filens preview report.pdf
- filens은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/IceWhaleTech/filens
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
PDF, Office 문서, HTML, 이미지, 오디오 등을 Markdown으로 변환해 LLM 및 텍스트 분석 파이프라인에 활용하는 Python 유틸리티입니다.
PDF, Office 파일, 이미지를 Markdown이나 JSON으로 변환해 LLM 및 에이전트 워크플로에서 활용하는 오픈소스 문서 파서입니다.
생성형 AI 파이프라인에서 사용할 수 있도록 PDF, Office 문서, HTML 등을 구조화된 데이터로 변환하는 오픈소스 문서 파서입니다.
Baidu의 오픈소스 비전-언어 OCR 모델로, 긴 다중 페이지 문서와 PDF를 한 번의 추론으로 구조화된 텍스트로 변환합니다.
PDF를 Markdown, 바운딩 박스가 포함된 JSON, HTML로 변환하고, 태그가 없는 PDF에 자동으로 태그를 추가해 Tagged PDF로 만드는 오픈소스 파서입니다.