zvec-ai/zvec-grep

어떤 프로젝트인가요?

핵심 기능

• 01ripgrep의 정확한 검색 및 정규식 검색에 BM25 키워드 순위 지정과 벡터 기반 의미 검색을 결합합니다.
• 02터미널의 zg CLI 또는 MCP 방식의 연동을 통한 AI 에이전트에서 사용할 수 있습니다.
• 03원본 위치 정보를 유지하면서 소스 코드, 문서, 구조화된 데이터를 인덱싱합니다.
• 04macOS, Linux, Windows에서 실행되며 npm 패키지에는 Node.js 22 이상이 필요합니다.
• 05기본적으로 파일, 인덱스, 로컬 모델을 머신 안에 보관합니다.

활용 사례

• 정확한 심볼 이름을 모를 때 대규모 저장소에서 코드 경로와 아키텍처 세부 정보를 찾습니다.
• AI 코딩 에이전트가 출처 링크와 순위가 포함된 결과로 로컬 프로젝트를 검색하도록 합니다.
• 여러 형식의 문서와 코드가 섞인 폴더를 정확한 키워드 대신 의미로 검색합니다.
• 파일을 원격 서비스에 보내지 않고 비공개 의미 검색을 실행합니다.

빠른 시작

1. 1

   npm에서 zg CLI를 설치합니다(Node.js 22 이상 필요).

   npm install -g @zvec/zvec-grep
2. 2

   로컬 임베딩 모델로 워크스페이스를 인덱싱합니다.

   zg index --embedding local/potion-retrieval-32m
3. 3

   터미널에서 검색을 실행합니다.

   zg query --human "An unseen creature left a few marks. What did the detective infer?" --limit 3

사용 전 알아둘 점

• !Node.js 22 이상이 필요합니다.
• !에이전트 예제는 OpenCode와 무료 모델 사용 가능 여부에 따라 달라지며, 이는 변경될 수 있습니다.

포함된 컬렉션

토픽

자주 묻는 질문

zvec-grep은(는) 무엇인가요?

워크스페이스에서 ripgrep, BM25, 벡터 검색을 결합해 사용하는 로컬 우선 검색 CLI이자 에이전트 도구입니다. zg(zvec-grep)는 워크스페이스의 파일을 검색하는 로컬 검색 도구입니다. ripgrep의 정확한 텍스트 및 정규식 매칭, BM25 키워드 순위 지정, 의미 기반 벡터 검색을 결합해 의미상 관련된 구절을 찾고 필요할 때 정확한 텍스트로 확인할 수 있습니다. zvec 벡터 데이터베이스를 기반으로 하며 Node.js 패키지로 제공됩니다. README에는 TypeScript/Node.js 구현이 설명되어 있고, 저장소에는 별도의 Rust 구현도 있습니다.

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

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

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

활발히 유지보수 중. zvec-grep의 마지막 커밋은 2026년 11월 5일입니다.

zvec-grep은(는) 어디에 사용할 수 있나요?

정확한 심볼 이름을 모를 때 대규모 저장소에서 코드 경로와 아키텍처 세부 정보를 찾습니다. AI 코딩 에이전트가 출처 링크와 순위가 포함된 결과로 로컬 프로젝트를 검색하도록 합니다. 여러 형식의 문서와 코드가 섞인 폴더를 정확한 키워드 대신 의미로 검색합니다. 파일을 원격 서비스에 보내지 않고 비공개 의미 검색을 실행합니다.

zvec-grep는 어떻게 설치하나요?

npm에서 zg CLI를 설치합니다(Node.js 22 이상 필요).: npm install -g @zvec/zvec-grep 로컬 임베딩 모델로 워크스페이스를 인덱싱합니다.: zg index --embedding local/potion-retrieval-32m 터미널에서 검색을 실행합니다.: zg query --human "An unseen creature left a few marks. What did the detective infer?" --limit 3

zvec-grep은(는) 어디서 받을 수 있나요?

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