v1.5.0.dev2 — Packaging & Dependency Fix
Release Date: 2026-08-14
Changes: v1.5.0.dev2 → fix/unconditional-ladybug-dependency
Summary
This release fixes an installation/runtime problem by making the 'ladybug' third‑party library a required runtime dependency for Cognee so it is installed automatically. The change improves startup reliability and reduces surprises caused by missing libraries during runtime.
Highlights
- Ladybug is now an unconditional runtime dependency — it will be installed automatically with Cognee.
- Packaging metadata updated so pip installs required runtime libraries without manual steps.
- Fixes ImportError/startup failures caused by the library previously being omitted.
- No new features — this release focuses on making installs and startup more reliable.
Breaking Changes
- None expected. Note: because ladybug is now installed automatically, new installations may pull that library (and any of its transitive dependencies), increasing package size. If you intentionally avoid ladybug, you will need to manage that via your packaging or environment tools.
New Features
- No new end-user features in this release. The release is focused on fixing packaging and dependency handling so Cognee runs reliably after install.
Improvements
- Packaging metadata now declares the ladybug library as a required dependency, so standard installers (pip, wheels) pull it in automatically. Why it matters: you no longer need to manually install that library to avoid runtime errors.
- Installer consistency: both source distributions and binary packages now include the runtime dependency declaration. Why it matters: installations behave the same across environments and reduce 'it works on my machine' problems.
Bug Fixes
- Resolved a startup ImportError caused by the ladybug library not being present after installation. What it does: Cognee will no longer fail at runtime due to that missing library. Why it matters: improves reliability and reduces troubleshooting for users installing Cognee in clean environments.
Technical Changes
- Updated packaging/dependency declarations to make ladybug an install_requires/runtime dependency. Why it matters: makes dependency management explicit and fixes cases where optional/conditional installation omitted a runtime requirement.
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-14