Base de datos vectorial de código abierto que almacena objetos y vectores juntos y combina la búsqueda por similitud con filtros estructurados.
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
Instala el cliente de Python desde PyPI
pip install qdrant-client - 2
Inicia un servidor de Qdrant localmente con Docker
docker run -p 6333:6333 qdrant/qdrant:latest - 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
Epsilla es una base de datos vectorial open source en C++ para búsquedas de similitud entre embeddings, con filtros de metadatos, búsqueda híbrida e integraciones de recuperación para LLM.
Pipeline de código abierto que renderiza páginas web y PDF como capturas de pantalla y permite buscarlas visualmente, conservando tablas y gráficos para RAG.
Qdrant es un motor de búsqueda de similitud vectorial y una base de datos vectorial basado en Rust, con filtros por payload, para búsquedas semánticas y recomendaciones.
Índice vectorial local y toolkit de RAG que reduce el almacenamiento cerca de un 97 % al recalcular embeddings bajo demanda, para buscar datos personales en tu laptop.
Base de datos de embeddings de código abierto para aplicaciones de IA, que almacena documentos y vectores para habilitar búsquedas semánticas, híbridas y de texto completo.