MinishLab/semble

어떤 프로젝트인가요?

핵심 기능

• 01자연어 또는 코드 검색어에 대해 순위가 매겨진 코드 조각을 반환합니다.
• 02API 키, GPU, 외부 서비스 없이 CPU에서 실행됩니다.
• 03검색 및 관련 항목 찾기 도구를 제공하는 MCP 서버를 지원합니다.
• 04스크립트와 맞춤형 도구 제작에 쓸 수 있는 CLI와 Python 라이브러리를 제공합니다.
• 05여러 로컬 또는 원격 git 저장소를 하나의 검색 대상으로 묶어 검색합니다.
• 06.gitignore와 .sembleignore를 따르며 인덱스를 증분 업데이트합니다.

활용 사례

• 대규모 코드베이스를 수정하기 전에 코딩 에이전트가 관련 함수를 찾도록 합니다.
• 여러 마이크로서비스 저장소에서 엔드포인트나 정의를 검색합니다.
• 파일 전체를 grep하고 읽는 에이전트 워크플로의 토큰 사용량을 줄입니다.
• 네트워크 API 호출 없이 CI 또는 샌드박스 환경에서 코드 검색을 스크립트로 실행합니다.

빠른 시작

1. 1

   uv를 설치합니다(uv 설치 가이드 참조)

2. 2

   uv 도구로 semble을 설치합니다

   uv tool install semble
3. 3

   대화형 설치 프로그램을 실행해 에이전트 연동을 설정합니다

   semble install

사용 전 알아둘 점

• !README에 따르면 처음 사용할 때 Hugging Face에서 특정 임베딩 모델을 다운로드하므로 네트워크 연결이 한 번 필요합니다.

포함된 컬렉션

토픽

자주 묻는 질문

semble은(는) 무엇인가요?

API 키 없이 CPU에서 실행되며, AI 코딩 에이전트에 필요한 코드 조각만 찾아주는 코드 검색 라이브러리입니다. Semble은 Claude Code, Cursor, Codex 같은 코딩 에이전트를 위한 코드 검색 라이브러리입니다. 자연어 또는 코드로 검색어를 입력하면 에이전트가 키워드를 grep하고 파일 전체를 읽는 대신, 저장소에서 일치하는 코드 조각을 찾아주므로 탐색에 드는 토큰을 줄일 수 있습니다.

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

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

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

활발히 유지보수 중. semble의 마지막 커밋은 2026년 11월 3일입니다.

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

대규모 코드베이스를 수정하기 전에 코딩 에이전트가 관련 함수를 찾도록 합니다. 여러 마이크로서비스 저장소에서 엔드포인트나 정의를 검색합니다. 파일 전체를 grep하고 읽는 에이전트 워크플로의 토큰 사용량을 줄입니다. 네트워크 API 호출 없이 CI 또는 샌드박스 환경에서 코드 검색을 스크립트로 실행합니다.

semble는 어떻게 설치하나요?

uv를 설치합니다(uv 설치 가이드 참조) uv 도구로 semble을 설치합니다: uv tool install semble 대화형 설치 프로그램을 실행해 에이전트 연동을 설정합니다: semble install

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

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