# Riskfolio Lib

> Portfolio risk and optimization: mean-variance, risk parity, CVaR, CDaR, worst-case, and robust optimization. Factor models, Black-Litterman, NCO. Supports plotting and interactive dashboards.

- Skill: `mkurman/riskfolio-lib` (Agent Skill)
- Install (CLI): `npx skillmds@latest add mkurman/riskfolio-lib`
- Raw SKILL.md: https://api.skillmd.com/api/skills/mkurman/riskfolio-lib/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: mkurman (https://skillmd.com/u/mkurman)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/mkurman/riskfolio-lib

---

## Overview

Riskfolio-Lib provides portfolio optimization beyond mean-variance: risk parity, CVaR, CDaR, worst-case, robust optimization, NCO (Network Clustering), and hierarchical methods. Includes factor models, Black-Litterman, and built-in plotting for efficient frontiers.

## Installation

```bash
uv pip install riskfolio-lib
```

## Mean-Variance Optimization

```python
import riskfolio as rp
import yfinance as yf

prices = yf.download(["AAPL", "MSFT", "GOOGL", "AMZN", "NVDA"], start="2022-01-01")["Close"]
returns = prices.pct_change().dropna()

port = rp.Portfolio(returns=returns)
port.assets_stats(method_mu="hist", method_cov="hist")

# Max Sharpe
w = port.optimization(model="Classic", rm="MV", obj="Sharpe", hist=True)
print("Optimal weights:", w.to_dict())

# Risk parity
w_rp = port.optimization(model="Classic", rm="MV", obj="MinRisk", hist=True)
```

## References
- [Riskfolio-Lib docs](https://riskfolio-lib.readthedocs.io/)
- [Riskfolio-Lib GitHub](https://github.com/dcajasn/Riskfolio-Lib)