QDrant Loader Core
Shared core library for the QDrant Loader ecosystem. It provides a provider‑agnostic LLM layer (embeddings and chat), configuration mapping, safe logging, and normalized error handling used by the CLI and MCP Server packages.
For provider, configuration, and architecture details, use the documentation links below.
🎯 What It Provides
- Provider-agnostic LLM facade for OpenAI, Azure OpenAI, OpenAI-compatible endpoints, and Ollama
- Unified async APIs for embeddings and chat clients
- Typed settings and mapping:
LLMSettings.from_global_config(...)supports the newglobal.llmschema and maps legacy fields with deprecation warnings - Structured logging with redaction:
LoggingConfig.setup(...)masks secrets and reduces noisy logs - Normalized errors: consistent exceptions across providers (
TimeoutError,RateLimitedError,InvalidRequestError,AuthError,ServerError) - Optional dependencies via extras:
openai,ollama
📦 Installation
pip install qdrant-loader-core
With extras:
pip install "qdrant-loader-core[openai]"
pip install "qdrant-loader-core[ollama]"
📄 Logging
Use built-in structured logging:
from qdrant_loader_core.logging import LoggingConfig
LoggingConfig.setup(level="INFO", format="console", file=None)
logger = LoggingConfig.get_logger(__name__)
logger.info("LLM ready", provider=settings.provider)
📝 Notes
- Secrets (keys/tokens) are masked in both stdlib and structlog output
- Noisy third‑party logs are toned down; Qdrant version checks are filtered
- For MCP integration, set
MCP_DISABLE_CONSOLE_LOGGING=trueto disable console output
❗ Error Handling
Catch provider-normalized exceptions from qdrant_loader_core.llm.errors:
TimeoutError— request timed outRateLimitedError— rate limit exceededInvalidRequestError— bad parameters or unsupported operationAuthError— authentication/authorization failedServerError— transport/server failures
📚 Documentation
- Getting Started - Quick start and core concepts
- Monorepo overview - Project structure, packages, and high-level navigation across the repository.
- Quick start - Fast setup path from install to first successful ingestion.
- User Guides - Detailed usage instructions
- Developer hub - Developer guides for architecture, testing, deployment, and contribution workflows.
- Architecture hub - System design, component interactions, and core technical decisions.
- Basic Configuration - Getting started with configuration
🆘 Support
- Issues - Bug reports and feature requests
- Discussions - Community Q&A
🤝 Contributing
See CONTRIBUTING - Contribution guidelines, development standards, and pull request process.
📄 License
This project is licensed under the Apache License 2.0 - see the LICENSE file for details.
Ready to get started? Check out our Quick Start Guide or browse the complete documentation.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file qdrant_loader_core-1.0.4.tar.gz.
File metadata
- Download URL: qdrant_loader_core-1.0.4.tar.gz
- Upload date:
- Size: 62.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
54c14fbc1ee794ce937471df8e8e17f31d6b5b7feeeeb054af067cf30ca0b4c6
|
|
| MD5 |
756983ac959f4a4a30dd9a83a385c843
|
|
| BLAKE2b-256 |
8d19a90d9194d14365ad86b40cecf15b8c049f1dd8ad28a5c15221bdfad317d5
|
Provenance
The following attestation bundles were made for qdrant_loader_core-1.0.4.tar.gz:
Publisher:
publish.yml on cbtw-apac/qdrant-loader
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
qdrant_loader_core-1.0.4.tar.gz -
Subject digest:
54c14fbc1ee794ce937471df8e8e17f31d6b5b7feeeeb054af067cf30ca0b4c6 - Sigstore transparency entry: 2209881413
- Sigstore integration time:
-
Permalink:
cbtw-apac/qdrant-loader@ccac2631033bc9a232bb508679a3e9a816f11f9e -
Branch / Tag:
refs/tags/qdrant-loader-core-v1.0.4 - Owner: https://github.com/cbtw-apac
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@ccac2631033bc9a232bb508679a3e9a816f11f9e -
Trigger Event:
release
-
Statement type:
File details
Details for the file qdrant_loader_core-1.0.4-py3-none-any.whl.
File metadata
- Download URL: qdrant_loader_core-1.0.4-py3-none-any.whl
- Upload date:
- Size: 51.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3899a0d9cba1a78ebbf0e7ab3c1964b6517ad22ec18eaea9c0a6cdf45518bb31
|
|
| MD5 |
7795f9cdfb298f7c2803d6ee26166a21
|
|
| BLAKE2b-256 |
5043552dc5759697353185d2c8d0be05f397ef95b999ef25fc54927acbd47177
|
Provenance
The following attestation bundles were made for qdrant_loader_core-1.0.4-py3-none-any.whl:
Publisher:
publish.yml on cbtw-apac/qdrant-loader
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
qdrant_loader_core-1.0.4-py3-none-any.whl -
Subject digest:
3899a0d9cba1a78ebbf0e7ab3c1964b6517ad22ec18eaea9c0a6cdf45518bb31 - Sigstore transparency entry: 2209881477
- Sigstore integration time:
-
Permalink:
cbtw-apac/qdrant-loader@ccac2631033bc9a232bb508679a3e9a816f11f9e -
Branch / Tag:
refs/tags/qdrant-loader-core-v1.0.4 - Owner: https://github.com/cbtw-apac
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@ccac2631033bc9a232bb508679a3e9a816f11f9e -
Trigger Event:
release
-
Statement type:
