Luma는 리눅스에서 앱과 파일을 찾고, 사진 속 내용이나 이미지에 적힌 글자로도 검색하는 런처다. 같은 사진 색인을 AI 에이전트가 조회할 수 있으며, 의미 검색과 OCR은 선택 기능이다.

설치는 저장소의 스크립트로 진행한다.

sh
curl -fsSL https://raw.githubusercontent.com/sakurartro/luma/main/install.sh | sh

스크립트는 실행 파일을 ~/.local/bin에 내려받는다. 다른 경로를 지정할 수도 있다. Luma는 Linux와 glibc 2.39 이상이 필요하며, 미리 빌드된 바이너리는 libfontconfig, libGL, libxkbcommon에 런타임 의존성이 있다. Wayland에서는 전역 키 입력을 직접 가로채지 않으므로, Hyprland나 niri 등의 설정에서 luma --toggle을 단축키에 연결해야 한다.

AI 에이전트는 MCP 서버(luma mcp)나 명령줄 인터페이스(luma query)로 사진 색인을 검색한다. 설정의 Agents 메뉴에서 Claude Code, Codex, opencode를 연결할 수 있고, API는 기본적으로 꺼져 있다. 사용하려면 Luma가 실행 중이어야 하며, 사진 내용 검색에는 semantic, 이미지 속 글자 검색에는 ocr를 켜고 색인 작업을 마쳐야 한다. 검색 대상은 search_dirs에 지정한 폴더로 제한된다.

의미 검색은 CLIP 모델 약 154MB, OCR은 PaddleOCR 모델 약 12MB를 내려받는다. 사진과 썸네일, 색인, 에이전트 검색 요청은 기기 안에 남는다. 다만 모델을 내려받을 때와 환율 기능을 사용할 때는 네트워크에 연결한다. 프로젝트는 GitHub 저장소에서 확인할 수 있다.