Connection refused
Verify that the Qdrant URL includes the correct port:
- gRPC connections (recommended): port 6334
- REST connections: port 6333
Authentication failures
Ensure the API key is correctly configured. For Qdrant Cloud, the API key is available in the cluster dashboard.
Empty search results
- Confirm the collection exists by storing at least one entry
- Check that the collection name matches between store and find operations
- Verify the query is semantically related to stored content
Model download failures
If the embedding model fails to download, check network connectivity and ensure
the cache directory is writable. The default cache location is
.fastembed_cache/ in the working directory.