To be fair, it started out as a set of ML notes and code snippets to piece together LLM applications. Its popularity resulted in more feature requests and contributions later on. Without a good up-front architecture (or spending time thinking about it), no wonder it starts making creaking noise.

My personal preference is Llama Index by Jerry Liu. It excels at clearer docs + better abstraction.