Repolode
qdrant

qdrant/qdrant-client

Biblioteca oficial de Python para el motor de búsqueda vectorial Qdrant, con acceso REST/gRPC síncrono y asíncrono, y modo local en memoria.

Estrellas
1,373
Forks
357
Issues abiertos
223
Último commit
hace 5 horas

¿Qué es?

qdrant-client es el SDK oficial de Python para Qdrant, un motor de búsqueda vectorial. Incluye definiciones de tipos para la API de Qdrant y permite realizar solicitudes síncronas y asíncronas mediante REST y gRPC, además de ofrecer métodos auxiliares para tareas habituales, como cargar una colección en bloque.

El cliente también ofrece un modo local que ejecuta la misma API sin servidor. Al pasar ":memory:" o una ruta de archivo, se crea una base de datos integrada, adecuada para crear prototipos, trabajar con notebooks y ejecutar suites de pruebas de CI. Cuando se necesita más capacidad, se puede conectar el mismo código a un servidor Qdrant en ejecución o a un clúster de Qdrant Cloud cambiando los parámetros de conexión.

Una API de inferencia opcional permite generar embeddings localmente mediante FastEmbed, con soporte opcional para GPU, o de forma remota con modelos alojados en Qdrant Cloud. Así se pueden insertar y consultar textos o imágenes sin una canalización de embeddings independiente.

Funciones clave

  • 01Sugerencias de tipos para todos los métodos de la API de Qdrant
  • 02Clientes síncronos y asíncronos mediante REST y gRPC
  • 03Modo local en memoria o en disco, sin necesidad de un servidor en ejecución
  • 04API de inferencia con FastEmbed local o modelos remotos de Qdrant Cloud
  • 05Métodos auxiliares para cargar vectores y puntos en bloque

Casos de uso

  • Crear backends de búsqueda semántica o generación aumentada por recuperación con Qdrant
  • Ejecutar pruebas de búsqueda vectorial en pipelines de CI sin desplegar un servidor
  • Crear prototipos de búsqueda basada en embeddings en notebooks de Jupyter o Colab
  • Desarrollar servicios asíncronos en Python que consulten un clúster de Qdrant

Inicio rápido

  1. 1

    Instala el cliente de Python desde PyPI

    pip install qdrant-client
  2. 2

    Inicia un servidor de Qdrant localmente con Docker

    docker run -p 6333:6333 qdrant/qdrant:latest
  3. 3

    Conéctate al servidor desde Python con QdrantClient(url="http://localhost:6333")

Antes de usarlo

  • Algunas funciones, como la inferencia remota, solo están disponibles en los planes de pago de Qdrant Cloud.
  • Para usar todas las funciones, se necesita Docker o una implementación independiente del servidor de Qdrant.

Temas

Preguntas frecuentes

¿Qué es qdrant-client?
Biblioteca oficial de Python para el motor de búsqueda vectorial Qdrant, con acceso REST/gRPC síncrono y asíncrono, y modo local en memoria. qdrant-client es el SDK oficial de Python para Qdrant, un motor de búsqueda vectorial. Incluye definiciones de tipos para la API de Qdrant y permite realizar solicitudes síncronas y asíncronas mediante REST y gRPC, además de ofrecer métodos auxiliares para tareas habituales, como cargar una colección en bloque.
¿qdrant-client es gratuito? ¿Qué licencia tiene?
qdrant-client es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿qdrant-client sigue mantenido?
Mantenimiento activo. El último commit de qdrant-client fue el 22 oct 2026.
¿Para qué puedo usar qdrant-client?
Crear backends de búsqueda semántica o generación aumentada por recuperación con Qdrant Ejecutar pruebas de búsqueda vectorial en pipelines de CI sin desplegar un servidor Crear prototipos de búsqueda basada en embeddings en notebooks de Jupyter o Colab Desarrollar servicios asíncronos en Python que consulten un clúster de Qdrant
¿Cómo se instala qdrant-client?
Instala el cliente de Python desde PyPI: pip install qdrant-client Inicia un servidor de Qdrant localmente con Docker: docker run -p 6333:6333 qdrant/qdrant:latest Conéctate al servidor desde Python con QdrantClient(url="http://localhost:6333")
¿Dónde consigo qdrant-client?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/qdrant/qdrant-client

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados