객체와 벡터를 함께 저장하고, 벡터 유사도 검색과 구조화된 필터링을 결합하는 오픈소스 벡터 데이터베이스입니다.
qdrant/qdrant-client
Qdrant 벡터 검색 엔진의 공식 Python 클라이언트 라이브러리로, 동기·비동기 REST/gRPC 액세스와 로컬 인메모리 모드를 제공합니다.
- 스타
- 1,373
- 포크
- 357
- 열린 이슈
- 223
- 마지막 커밋
- 5시간 전
어떤 프로젝트인가요?
qdrant-client는 벡터 검색 엔진 Qdrant의 공식 Python SDK입니다. Qdrant API의 타입 정의를 포함하며 REST와 gRPC를 통한 동기·비동기 요청을 모두 지원하고, 컬렉션 대량 업로드와 같은 일반적인 작업을 위한 헬퍼 메서드도 제공합니다.
또한 서버 없이 동일한 API를 실행하는 로컬 모드를 제공합니다. ":memory:" 또는 파일 경로를 전달하면 내장 데이터베이스가 생성되어 프로토타이핑, 노트북, CI 테스트 스위트에 적합합니다. 더 큰 용량이 필요하면 연결 매개변수를 변경해 같은 코드를 실행 중인 Qdrant 서버나 Qdrant Cloud 클러스터에 연결할 수 있습니다.
선택 사항인 Inference API를 사용하면 FastEmbed를 통해 GPU를 선택적으로 지원하는 로컬 임베딩을 생성하거나 Qdrant Cloud에서 호스팅하는 모델을 통해 원격으로 생성할 수 있습니다. 따라서 별도의 임베딩 파이프라인 없이 텍스트나 이미지를 삽입하고 검색할 수 있습니다.
핵심 기능
- 01모든 Qdrant API 메서드의 타입 힌트
- 02REST 및 gRPC를 지원하는 동기·비동기 클라이언트
- 03실행 중인 서버 없이 사용할 수 있는 로컬 인메모리 또는 디스크 모드
- 04로컬 FastEmbed 또는 원격 Qdrant Cloud 모델을 사용하는 Inference API
- 05벡터와 포인트를 대량 업로드하는 헬퍼 메서드
활용 사례
- Qdrant 기반 시맨틱 검색 또는 검색 증강 생성 백엔드 구축
- 서버를 배포하지 않고 CI 파이프라인에서 벡터 검색 테스트 실행
- Jupyter 또는 Colab 노트북에서 임베딩 기반 검색 프로토타이핑
- Qdrant 클러스터를 조회하는 비동기 Python 서비스 작성
빠른 시작
- 1
PyPI에서 Python 클라이언트를 설치합니다
pip install qdrant-client - 2
Docker로 Qdrant 서버를 로컬에서 시작합니다
docker run -p 6333:6333 qdrant/qdrant:latest - 3
QdrantClient(url="http://localhost:6333")를 사용해 Python에서 서버에 연결합니다
사용 전 알아둘 점
- 원격 추론과 같은 일부 기능은 유료 Qdrant Cloud 요금제에서만 사용할 수 있습니다.
- 모든 기능을 사용하려면 Docker 또는 별도로 배포된 Qdrant 서버가 필요합니다.
토픽
자주 묻는 질문
- qdrant-client은(는) 무엇인가요?
- Qdrant 벡터 검색 엔진의 공식 Python 클라이언트 라이브러리로, 동기·비동기 REST/gRPC 액세스와 로컬 인메모리 모드를 제공합니다. qdrant-client는 벡터 검색 엔진 Qdrant의 공식 Python SDK입니다. Qdrant API의 타입 정의를 포함하며 REST와 gRPC를 통한 동기·비동기 요청을 모두 지원하고, 컬렉션 대량 업로드와 같은 일반적인 작업을 위한 헬퍼 메서드도 제공합니다.
- qdrant-client은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- qdrant-client은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- qdrant-client은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. qdrant-client의 마지막 커밋은 2026년 10월 22일입니다.
- qdrant-client은(는) 어디에 사용할 수 있나요?
- Qdrant 기반 시맨틱 검색 또는 검색 증강 생성 백엔드 구축 서버를 배포하지 않고 CI 파이프라인에서 벡터 검색 테스트 실행 Jupyter 또는 Colab 노트북에서 임베딩 기반 검색 프로토타이핑 Qdrant 클러스터를 조회하는 비동기 Python 서비스 작성
- qdrant-client는 어떻게 설치하나요?
- PyPI에서 Python 클라이언트를 설치합니다: pip install qdrant-client Docker로 Qdrant 서버를 로컬에서 시작합니다: docker run -p 6333:6333 qdrant/qdrant:latest QdrantClient(url="http://localhost:6333")를 사용해 Python에서 서버에 연결합니다
- qdrant-client은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/qdrant/qdrant-client
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
Epsilla는 메타데이터 필터링, 하이브리드 검색, LLM 검색 연동을 지원하는 임베딩 유사도 검색용 오픈 소스 C++ 벡터 데이터베이스입니다.
웹 페이지와 PDF를 스크린샷으로 렌더링해 시각적으로 검색하는 오픈소스 파이프라인으로, 표와 차트를 RAG에 그대로 보존합니다.
Qdrant는 시맨틱 검색과 추천을 위한 Rust 기반 벡터 유사도 검색 엔진이자 페이로드 필터링을 지원하는 벡터 데이터베이스입니다.
필요할 때 임베딩을 다시 계산해 저장 공간을 약 97% 줄이는 로컬 벡터 인덱스 및 RAG 툴킷으로, 노트북에서 개인 데이터를 검색할 수 있습니다.
AI 앱을 위한 오픈 소스 임베딩 데이터베이스로, 문서와 벡터를 저장해 시맨틱·하이브리드·전체 텍스트 검색을 지원합니다.