v1.4.2 — Search & Reliability Improvements
Release Date: 2026-08-08
Changes: v1.4.2 → main
Summary
This release improves search relevance, ingestion reliability, and developer ergonomics across Cognee. It includes new features that make indexing and querying your stored documents more accurate, performance improvements for large uploads, and several bug fixes that reduce unexpected errors.
Highlights
- Smarter dataset indexing for better search results
- More reliable and faster ingestion of large files
- Improved developer SDK and clearer error messages
- Multiple bug fixes that reduce crashes and duplicate results
Breaking Changes
- No breaking API changes in v1.4.2. Existing integrations should continue to work as before. If you use custom ingestion workflows that rely on internal timing of indexing runs, consider using the new admin controls to coordinate re-indexing.
New Features
- Smarter dataset indexing: A new optional indexing mode that groups a dataset (a collection of documents you add to Cognee) into topic clusters and generates short overviews for each cluster. What it does: gives search broader context about a dataset so queries return more relevant results. Why it matters: search results are less likely to miss related information and you get higher-quality answers from fewer queries.
- Admin controls for indexing: New controls in the admin interface to start, pause, and re-run dataset indexing. What it does: lets you control when dataset re-indexing happens and retry failed runs easily. Why it matters: you can avoid heavy background indexing during peak hours and quickly recover from interrupted ingestions.
- SDK convenience updates: Client libraries have new helper functions for common ingestion and query flows. What it does: simplifies code for uploading documents and running searches. Why it matters: developers can integrate Cognee faster with fewer lines of code and less chance for mistakes.
Improvements
- Higher search relevance: Query ranking was tuned so results that match the general topic of a dataset surface above less relevant matches. This improves the practical usefulness of top search hits.
- More robust ingestion: Upload and processing logic now better handles large files and intermittent network failures by automatically retrying and resuming work where possible. This reduces failed ingestions and duplicated work.
- Clearer error messages: User-facing and API errors are now more descriptive and actionable, so you can identify and fix issues faster without digging into logs.
- Improved metadata handling: Metadata attached to documents (tags, source, timestamps) is preserved more consistently during ingestion and indexing, reducing mismatches in search filters.
Performance
- Faster ingestion of large files: Optimizations reduce the time to process multi-GB files, so large uploads complete noticeably faster.
- Lower memory usage during indexing: Memory improvements mean indexing larger datasets requires less RAM, which helps when running on smaller instances.
Security
- Hardening around credentials handling: Better validation and lifecycle handling for API tokens and session credentials to reduce accidental exposure and stale tokens.
Bug Fixes
- Fixed duplicate search results: Resolved cases where the same document could appear multiple times in query results.
- Fixed occasional ingestion crashes: Addressed rare crashes that occurred with certain malformed inputs during ingestion.
- Fixed UI sync issues: Resolved cases where the admin UI showed stale indexing status after background changes.
Technical Changes
- Internal refactors to the indexing pipeline that improve maintainability and make future features (like incremental dataset summaries) easier to add.
- Updated several internal dependencies to their latest safe versions to improve reliability and security.
Compatibility
| Component | Supported / Required |
|---|---|
| Python | >=3.10,<3.15 |
| pydantic | >=2.10.5 |
| litellm | >=1.83.7 |
| fastapi | >=0.116.2,<1.0.0 |
| sqlalchemy | >=2.0.39,<3.0.0 |
| lancedb | >=0.24.3,<1.0.0 |
| ladybug | >=0.16.0,<=0.18.2 |
— The Cognee Team · 2026-08-08