BACKGROUND: Traditional risk models for immunoglobulin A nephropathy (IgAN), which primarily rely on renal indicators, lack comprehensive assessment and therapeutic guidance, necessitating more refined and integrative approaches. OBJECTIVE: This study integrated network biomarkers with unsupervised learning clustering (k-means clustering based on network biomarkers [KMN]) to refine risk stratification in IgAN and explore its clinical value. METHODS: Involving a multicenter prospective cohort, we analyzed 1460 patients and validated the approach externally with 200 additional patients. Deeper metabolic and microbiomic insights were gained from 2 distinct cohorts: 63 patients underwent ultraperformance liquid chromatography-mass spectrometry, while another 45 underwent fecal 16S RNA sequencing. Our approach used hierarchical clustering and k-means methods, using 3 sets of indicators: demographic and renal indicators, renal and extrarenal indicators, and network biomarkers derived from all indicators. RESULTS: Among 6 clustering methods tested, the KMN scheme was the most effective, accurately reflecting patient severity and prognosis with a prognostic accuracy area under the curve (AUC) of 0.77, achieved solely through cluster grouping without additional indicators. The KMN stratification significantly outperformed the existing International IgA Nephropathy Prediction Tool (AUC of 0.72) and renal function-renal histology grading schemes (AUC of 0.69). Clinically, this stratification facilitated personalized treatment, recommending angiotensin-converting enzyme inhibitors or angiotensin receptor blockers for lower-risk groups and considering immunosuppressive therapy for higher-risk groups. Preliminary findings also indicated a correlation between IgAN progression and alterations in serum metabolites and gut microbiota, although further research is needed to establish causality. CONCLUSIONS: The effectiveness and applicability of the KMN scheme indicate its substantial potential for clinical application in IgAN management.