xerj-org/xerj

어떤 프로젝트인가요?

핵심 기능

• 01명령 하나로 폴더의 파일 형식을 자동 감지하고 데이터셋별 인덱스를 생성합니다.
• 02tree-sitter로 소스 코드를 파싱해 심볼과 줄 번호를 유지합니다.
• 03Elasticsearch 호환 REST API를 제공해 기존 클라이언트와 Kibana를 바로 연결할 수 있습니다.
• 04하나의 엔진에서 BM25 전문 검색, kNN 벡터 검색, 하이브리드 검색을 지원합니다.
• 05Claude Code, Cursor 같은 에이전트용 MCP 서버를 제공합니다.
• 06Linux, macOS, Windows용 단일 정적 바이너리로 배포되며 JVM이 필요하지 않습니다.

활용 사례

• 파일 전체를 읽는 대신 코딩 에이전트가 코드베이스에서 특정 함수를 정확히 찾도록 합니다.
• 별도의 벡터 데이터베이스 없이 로컬 문서에 대한 RAG 또는 코드베이스 Q&A를 구축합니다.
• 소스 트리 전체에서 sink 패턴이나 시크릿을 검색해 보안 감사를 수행합니다.
• 단일 머신에서 로그 분석을 위해 자체 호스팅 Elasticsearch 배포를 대체합니다.

빠른 시작

1. 1

   바이너리를 다운로드하고 설치합니다

   README의 공식 안내에 따라 설치
2. 2

   로컬 개발용으로 서버를 시작합니다(TLS 및 인증 없음)

   xerj --insecure --data-dir ./data &
3. 3

   원하는 폴더를 인덱싱합니다

   xerj autoindex ~/my-project
4. 4

   인덱싱된 폴더를 대상으로 검색 쿼리를 실행합니다

   xerj search "how do we rotate the WAL segment"

사용 전 알아둘 점

• !--insecure 플래그를 사용하면 TLS와 API 키 인증이 비활성화되므로 개발용 머신에서 한 명만 사용하는 경우에만 안전합니다.
• !신경망 임베딩 모드는 선택 사항이며, 약 90MB의 모델 파일을 다운로드합니다.

토픽

자주 묻는 질문

xerj은(는) 무엇인가요?

폴더를 자동 인덱싱하고 Elasticsearch API를 제공하는 Rust 기반 로컬 AI 검색 엔진 XERJ는 `xerj autoindex <folder>` 명령 하나로 폴더를 인덱싱하는 단일 Rust 바이너리입니다. 파일 형식을 자동으로 감지해 데이터셋마다 검색 가능한 인덱스를 하나씩 생성합니다. 소스 코드(tree-sitter로 파싱해 심볼과 줄 번호 유지), CSV, JSON, YAML, SQLite, PDF, Office 문서, 이메일, 로그 파일을 지원하며, 스키마나 파이프라인을 직접 작성할 필요가 없습니다.

xerj은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

xerj은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

xerj은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. xerj의 마지막 커밋은 2026년 10월 19일입니다.

xerj은(는) 어디에 사용할 수 있나요?

파일 전체를 읽는 대신 코딩 에이전트가 코드베이스에서 특정 함수를 정확히 찾도록 합니다. 별도의 벡터 데이터베이스 없이 로컬 문서에 대한 RAG 또는 코드베이스 Q&A를 구축합니다. 소스 트리 전체에서 sink 패턴이나 시크릿을 검색해 보안 감사를 수행합니다. 단일 머신에서 로그 분석을 위해 자체 호스팅 Elasticsearch 배포를 대체합니다.

xerj는 어떻게 설치하나요?

바이너리를 다운로드하고 설치합니다 로컬 개발용으로 서버를 시작합니다(TLS 및 인증 없음): xerj --insecure --data-dir ./data & 원하는 폴더를 인덱싱합니다: xerj autoindex ~/my-project 인덱싱된 폴더를 대상으로 검색 쿼리를 실행합니다: xerj search "how do we rotate the WAL segment"

xerj은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/xerj-org/xerj