How songalobung/mizani works
Mizani is a pension-allocation optimizer and CLI: users provide market data, portfolio holdings, fund settings, and jurisdiction rules; the CLI validates and estimates inputs, then runs optimization or related analysis and produces results or reports. Its main domain stages are input validation, estimation and rule compilation, optimization, and compliance/transition and regulation analytics. The README documents capabilities beyond the sampled excerpts, including multiple solver methods and regulation data as YAML. Edges are limited to README statements and shown source references; unsampled details are not inferred.
Main entry points: cli.py Mizani CLI · optimizers.py Portfolio Solvers · report.py Analysis Report · frontier.py Efficient Frontier
Components 16
Inputs and Validation
- Market Data
data/templates - Portfolio Holdings
data/templates/portfolio.csv - Regulation Rules
regulations - Input Schemas
src/mizani/schemas.py - Data Loaders
src/mizani/loaders.py
Quantitative Engine
- Return Estimation
src/mizani/estimation.py - Rule Compiler
src/mizani/rules.py - Portfolio Solvers
src/mizani/optimizers.py
Analysis and Transition
- Compliance Audit
src/mizani/compliance.py - Efficient Frontier
src/mizani/frontier.py - Regulation Cost
src/mizani/regcost.py - Rebalance Planner
src/mizani/rebalance.py - Scenario Analysis
src/mizani/scenarios.py
User Interface
- Mizani CLI
src/mizani/cli.py - Analysis Report
src/mizani/report.py
Other components
- Fund Manager
Connections 32
- Fund Manager → Mizani CLI: runs commands
README.md - Market Data → Mizani CLI: supplies data
README.md - Portfolio Holdings → Mizani CLI: supplies holdings
README.md - Regulation Rules → Mizani CLI: supplies rules
README.md - Mizani CLI → Data Loaders: loads inputs
src/mizani/cli.py - Data Loaders → Input Schemas: validates with
src/mizani/loaders.py - Mizani CLI → Return Estimation: estimates returns
src/mizani/cli.py - Mizani CLI → Portfolio Solvers: solves allocation
README.md - Mizani CLI → Compliance Audit: checks holdings
src/mizani/cli.py - Mizani CLI → Efficient Frontier: generates frontier
src/mizani/cli.py - Mizani CLI → Regulation Cost: analyzes regulation cost
src/mizani/cli.py - Mizani CLI → Rebalance Planner: plans rebalancing
src/mizani/cli.py - Mizani CLI → Scenario Analysis: compares scenarios
src/mizani/cli.py - Mizani CLI → Analysis Report: generates report
README.md - Portfolio Solvers → Return Estimation: uses estimates
src/mizani/optimizers.py - Portfolio Solvers → Rule Compiler: uses constraints
src/mizani/optimizers.py - Efficient Frontier → Portfolio Solvers: uses solvers
src/mizani/frontier.py - Efficient Frontier → Return Estimation: uses estimates
src/mizani/frontier.py - Efficient Frontier → Rule Compiler: uses constraints
src/mizani/frontier.py - Compliance Audit → Data Loaders: loads holdings
src/mizani/compliance.py - Rebalance Planner → Compliance Audit: checks transitions
src/mizani/rebalance.py - Rebalance Planner → Rule Compiler: uses constraints
src/mizani/rebalance.py - Regulation Cost → Portfolio Solvers: compares solutions
src/mizani/regcost.py - Regulation Cost → Return Estimation: uses estimates
src/mizani/regcost.py - Scenario Analysis → Return Estimation: shocks estimates
src/mizani/scenarios.py - Scenario Analysis → Portfolio Solvers: compares allocations
src/mizani/scenarios.py - Scenario Analysis → Regulation Cost: compares regulation cost
src/mizani/scenarios.py - Analysis Report → Compliance Audit: includes audit
src/mizani/report.py - Analysis Report → Efficient Frontier: includes frontier
src/mizani/report.py - Analysis Report → Regulation Cost: includes cost analysis
src/mizani/report.py - Analysis Report → Rebalance Planner: includes trades
src/mizani/report.py - Analysis Report → Portfolio Solvers: includes allocation
src/mizani/report.py