How poojaellanti/maica works
This repository combines an investment-advisor workflow with MAICA responsible-AI auditing. The main user path collects a profile in the web UI, requests a recommendation, profiles risk, generates a portfolio, fetches market prices, and invokes an audit coordinator. The audit agents provide distinct inspection, regulation, monitoring, explainability, security, data-protection, and comparison capabilities; their relationships to the coordinator are not established by the sampled coordinator source, so those links are omitted. Several dashboards and audit entry points are documented by source imports, but their unsampled internals are not inferred.
Main entry points: app.py Recommendation API · maica_dashboard.py Portfolio Audit Dashboard · maica_investment_audit.py Investment Audit Runner · risk_profiler.py Risk Profiler
Components 22
Investment Advisor
- Advisor Web UI
frontend/script.js - Recommendation API
investment_app/app.py - Risk Profiler
investment_app/risk_profiler.py - Portfolio Generator
investment_app/portfolio_model.py - Market Snapshot
investment_app/stock_fetcher.py - Portfolio Audit Dashboard
maica_dashboard.py
MAICA Audit
- Audit Integration
investment_app/audit_integration.py - Report Coordinator
agents/coordinator_agent.py - Regulation Checks
agents/regulation_agent.py - Model Inspection
agents/model_inspection_agent.py - Runtime Monitoring
agents/monitoring_agent.py - Explainability
agents/explainability_agent.py - Security Checks
agents/security_agent.py - Data Protection
agents/data_protection_agent.py - Audit Comparison
agents/comparison_agent.py - Investment Audit Runner
maica_investment_audit.py - Audit UI
ui_app.py
Audit Data
- Adult Audit Data
data/adult_model_setup.py - Healthcare Setup
data/healthcare_model_setup.py - Manual Audit Workbook
manual_audit/Manual_Audit_Adult.xlsx
Other components
- Investor
- Yahoo Finance
Connections 16
- Investor → Advisor Web UI: enters profile
frontend/script.js - Advisor Web UI → Recommendation API: requests recommendation
frontend/script.js - Recommendation API → Risk Profiler: determines risk
investment_app/app.py - Recommendation API → Portfolio Generator: generates portfolio
investment_app/app.py - Recommendation API → Market Snapshot: fetches snapshot
investment_app/app.py - Market Snapshot → Yahoo Finance: queries prices
investment_app/stock_fetcher.py - Recommendation API → Audit Integration: runs audit
investment_app/app.py - Audit Integration → Report Coordinator: requests report
investment_app/audit_integration.py - Portfolio Audit Dashboard → Risk Profiler: determines risk
maica_dashboard.py - Portfolio Audit Dashboard → Portfolio Generator: generates portfolio
maica_dashboard.py - Portfolio Audit Dashboard → Report Coordinator: requests report
maica_dashboard.py - Investment Audit Runner → Risk Profiler: determines risk
maica_investment_audit.py - Investment Audit Runner → Portfolio Generator: generates portfolio
maica_investment_audit.py - Investment Audit Runner → Report Coordinator: requests report
maica_investment_audit.py - Audit Comparison → Manual Audit Workbook: loads workbook
agents/comparison_agent.py - Adult Audit Data → Adult Audit Data: writes audit CSV
data/adult_model_setup.py