Release Notes - v1.0.1.dev1

Release Date: 2026-04-15
Changes: v1.0.1.dev1 → add-ontologies-to-user-dir

Summary

This release introduces per-user ontology storage so you can add, manage, and persist custom ontologies outside the application package. It improves reliability around ontology loading and includes small bug fixes and internal cleanups to make the platform more robust and easier to customize.

Highlights

• Ontologies can now be stored and loaded from a user-specific directory, allowing persistent, upgrade-safe customizations.
• Improved ontology loading and error handling for more reliable behavior at startup.
• Clearer guidance and messaging when user ontologies are missing or malformed.
• Minor bug fixes and internal refactors to improve stability.

Breaking Changes

• Default storage location for ontologies has changed to a user-specific directory. If you previously relied on editing ontologies inside the application package, you should move any custom ontology files to the new user directory so they persist across upgrades.
• If you have tooling that assumes ontologies live in the application package directory, update it to target the user data directory instead. Consult the docs for the exact path for your OS and recommended migration steps.

New Features

• Per-user ontology directory: Cognee now discovers and loads ontologies from a user-specific data directory. This lets users add custom ontologies without modifying application package files or risking loss during upgrades.
• Auto-discovery of user ontologies on startup: the system will automatically look for ontologies in the configured user data location and load any valid files found.

Improvements

• Improved error messages and logging when an ontology fails to load — you’ll get clearer guidance on what went wrong and how to fix it.
• More robust path handling and permission checks when accessing user files to reduce startup errors on different OSes.
• Documentation and help text updated to explain where to place custom ontologies and how Cognee loads them.

Bug Fixes

• Resolved several cases where ontologies inside the package could be ignored or skipped during load.
• Fixed path-resolution and permission-related startup errors observed on some systems when reading ontology files.
• Addressed a crash scenario when a malformed ontology file was present in the search path; Cognee now skips the bad file and logs a clear error instead of aborting.

Technical Changes

• Refactored file- and path-handling code around ontology loading to centralize discovery logic and improve cross-platform behavior.
• Added additional tests around ontology discovery and error handling to prevent regressions.
• Minor internal cleanup and dependency updates related to file I/O.

Generated by Cognee Release Notes Generator on 2026-04-15