Repolode
qdrant

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. 1

    PyPI에서 Python 클라이언트를 설치합니다

    pip install qdrant-client
  2. 2

    Docker로 Qdrant 서버를 로컬에서 시작합니다

    docker run -p 6333:6333 qdrant/qdrant:latest
  3. 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 통계는 매일 갱신됩니다.

관련 프로젝트