Mangaku - Manhwa & Manhua Recommender
An AI manhwa recommender over 81k+ manhwa and manhua with explainable natural-language search — every result shows which tags it matched.
The problem
Readers describe what they want in plain language — "regression revenge story with an overpowered lead" — but catalogue search only matches titles and tag filters only match exactly. Pure semantic search solves the language problem and creates a new one: results arrive with no explanation, so there is no reason to trust any of them.
The solution
A hybrid Qdrant retrieval pipeline fuses semantic embeddings with weighted structured-tag matching, so a query is matched on meaning and on the concrete tags it implies rather than on one or the other. Every recommendation is returned with the tags it shares with the query, which makes the result auditable instead of a black box. Three ways to search run on one backend — by title, by description, or by chat. Built solo, end to end, with React/TypeScript as a PWA, FastAPI, Qdrant and OpenAI.
The result
Natural-language search across 81,000+ manhwa and manhua, with every result carrying its own explanation of why it matched. Three search modes share a single backend and retrieval pipeline, so there is one index to maintain rather than three.
Skills used
- AI
- ML
- React
- TypeScript
- FastAPI
- Qdrant
- OpenAI
- PWA


