How dommetipavan26-tech/chaoshire works
ChaosHire is a hiring-model fairness-auditing prototype. Its main workflow accepts a demo, uploaded, or adapter-backed decision set, evaluates group fairness and controlled counterfactual stress tests, then exposes evidence and reports for review. Separate branches support candidate explanations and appeals, mitigation simulations, model training/comparison, and aggregate audit history. The excerpts show selected implementation details, but not all route bodies or subsystem calls; dashed, unevidenced links mark relationships that are documented as capabilities or strongly implied rather than verified from the excerpts.
Main entry points: app.py HTTP API · services.py Audit services · chaoshire.js Dashboard · models.py Scoring models
Components 21
Audit workflow
- Audit services
chaoshire/services.py - Decision adapters
chaoshire/adapters.py - Fairness metrics
chaoshire/metrics.py - Chaos experiments
chaoshire/chaos.py - Release comparison
chaoshire/quality.py
Review and governance
- Candidate explanations
chaoshire/explain.py - Mitigation simulations
chaoshire/services.py - Appeals workflow
chaoshire/services.py - Evidence bundles
chaoshire/evidence.py - HTML and PDF reports
chaoshire/reporting.py
Models and data
- Scoring models
chaoshire/models.py - Model training
chaoshire/training.py - Synthetic candidates
chaoshire/data.py
Persistence and operations
- Application state
chaoshire/state.py - Audit history
chaoshire/repository.py - PostgreSQL adapter
chaoshire/repository_postgres.py - Event webhook
chaoshire/loghook.py
Other components
- Operator
Connections 22
- Operator → Dashboard: uses
- Operator → CLI: invokes
- Operator → HTTP API: submits requests
- Dashboard → HTTP API: requests audits
- HTTP API → Audit services: dispatches
chaoshire/app.py - Audit services → Decision adapters: loads decisions
- Audit services → Fairness metrics: calculates metrics
chaoshire/services.py - Audit services → Chaos experiments: runs tests
- Audit services → Scoring models: builds decisions
chaoshire/services.py - Audit services → Audit history: stores aggregates
chaoshire/services.py - HTTP API → Mitigation simulations: requests simulation
chaoshire/app.py - HTTP API → Candidate explanations: requests explanation
chaoshire/app.py - HTTP API → Appeals workflow: records appeals
chaoshire/app.py - HTTP API → Evidence bundles: serves verification
chaoshire/app.py - HTTP API → HTML and PDF reports: serves reports
chaoshire/app.py - Release comparison → Fairness metrics: compares audits
chaoshire/quality.py - Model training → Synthetic candidates: fits on
chaoshire/training.py - Scoring models → Synthetic candidates: scores
chaoshire/models.py - Audit history → PostgreSQL adapter: delegates optionally
chaoshire/repository.py - Appeals workflow → Application state: appends appeal
chaoshire/services.py - Appeals workflow → Event webhook: ships event
chaoshire/services.py - HTTP API → Dashboard: serves interface assets