Prepare for Hugging Face Spaces deployment

Clean codebase: remove demographic clustering and test files

Fix UserTower attention masking and update terminology

Clean codebase and add demographic enhancements

Add comprehensive documentation and interactive similar items feature

Major codebase cleanup and feature additions

initial generation