Windows Said No: The Long Path Bug That Broke Vector Storage in Cognee

TL;DR AI
2 min readKey summary
Cognee’s vector storage on Windows could fail with OSError [WinError 3] when long project paths hit the legacy 260-character limit.
The issue came from paths reaching LanceDB without the Windows long-path prefix, especially inside subprocesses.
The fix normalizes vector_db_url in Cognee so Windows absolute paths get the proper prefix, while relative, Unix, and already-prefixed paths remain unchanged.
The bug underscores the need for careful cross-platform path handling in open source AI and RAG tooling.
