MARVIS-Agent

Tell MARVIS what risk decision you need.
It turns local data into governed analysis, models, strategies, and audit-ready deliverables.

English · 中文

One workbench for local risk analysis and development—from data to strategy and reports.

From a request to a reviewable result

MARVIS is a local-first, governed credit-risk Agent platform—not a chatbot wrapped around a collection of scripts.

Describe the business outcome in natural language. MARVIS asks for missing files and definitions, builds a reviewable plan, pauses at responsibility gates, runs deterministic tools, and returns real datasets, evidence, models, strategy code, and reports.

flowchart LR
    A["Describe the risk goal"] --> B["Agent clarifies inputs and definitions"]
    B --> C["Validated workflow plan"]
    C --> D{"Human confirmation<br/>where required"}
    D --> E["Deterministic tools execute"]
    E --> F["Evidence, artifacts, and reports"]
    F --> G["Review, adopt, and iterate"]

What the current V2 delivers

• A complete seven-step strategy-development workflow: current and historical evidence, governed dual-population samples, univariate and model evidence, trees, Cross, scorecards, Voting, Strategy Pools, impact measurement, validation, code delivery, and four-format review reports.
• A governed data-to-model workflow: ingest and join files, analyze and engineer features, train and compare multiple recipes, export PMML, score data, generate model reports, and hand the selected model and supporting evidence directly into model validation. PMML export is available for supported recipes.
• Conversational risk analysis: MARVIS first asks what to analyze and which fields, units, dates, scenarios, and assumptions apply. It then runs the selected VTG-terminal/annualized-bad-rate or profitability calculation and delivers an audited Excel report. Standard Vintage and roll-rate are separate governed workflows with structured evidence and artifacts.

Why risk teams use MARVIS

Agent mode and the Manual Workbench share the same validated workflows, tools, schemas, and deterministic calculation kernels.

One workbench for end-to-end local risk analysis and development

The six primary desktop entries are Data Processing, Feature Analysis, Risk Analysis, Model Development, Model Validation, and Strategy Development. Monitoring is integrated into model and strategy workflows. Portfolio tools, templates, and report rendering are implemented and tested, but portfolio is not currently exposed as a first-screen or supported conversational Agent task.

Strategy development, end to end

Strategy work is where MARVIS goes furthest beyond “AI assistance.” The current V2 workflow follows the real seven-step development process:

1. Understand the current project — approval rate, risk level, profitability, population, metric definitions, and known constraints.
2. Review historical versions — compare prior strategy evidence, outcomes, assumptions, and reusable lessons.
3. Design the sample — create governed approval and risk populations, development/validation/OOT partitions, maturity rules, labels, weights, and immutable membership evidence.
4. Evaluate variables and models — produce deterministic univariate, score-band, model, lift, stability, and risk evidence.
5. Develop combinations — build and refine single rules, automatic and interactive trees, 2D Cross Matrix, 2D/3D cross-threshold searches, scorecards, and Voting/n-of-k candidates for approval, reject, limit, pricing, and segmentation in a common Strategy Pool.
6. Measure impact — replay the strategy by month, segment, amount, and partition; compare approval rate, bad rate, swap, and risk; measure profitability where the required economics are available; and run stability and independent validation checks.
7. Deliver the review package — materialize a canonical strategy, verify equivalent Python/DuckDB SQL/JSON execution, and generate JSON/Markdown/XLSX/DOCX reports aligned to a seven-section strategy review.

If optional report information is unavailable, MARVIS asks for it. When the user explicitly says it is not currently available, the report keeps that field blank instead of inventing content.

Example requests

You can start with requests like:

Join the application table with the bureau features. Check key precision, duplicate keys, match rate, and row inflation before asking me to approve the join.

Compare logistic regression, LightGBM, and a scorecard. Keep an OOT sample, explain leakage risks, and do not select the champion until I confirm.

Build a new-customer approval strategy with bad rate no higher than 5% and approval rate at least 60%. Ask me for anything needed before you design the sample.

Calculate VTG terminal and annualized bad rate. First list the tables, columns, units, cut-off date, scenario, and assumptions you need from me.

Outputs, not just chat

Depending on the workflow, MARVIS produces:

• immutable derived datasets and safe CSV/XLSX exports;
• feature evidence and downloadable feature-analysis workbooks;
• experiment comparisons, scored data, PMML, model cards, monitoring policies, and model-development reports;
• validation evidence and Excel/Word validation reports;
• canonical strategy assets, versioned backtests, ImpactCube and stability evidence, equivalent Python/DuckDB SQL/JSON implementations, and four-format review bundles;
• audited VTG/annualized-bad-rate or profitability Excel reports, plus structured Vintage, roll-rate, monitoring, and portfolio artifacts;
• provenance, hashes, confirmation records, tool-run logs, and auditable memory references.

Responsible automation

MARVIS automates work without pretending that responsibility disappeared:

• The Agent understands, clarifies, plans, summarizes, and explains.
• Platform tools own deterministic metrics, rules, sample membership, backtests, impact calculations, and report numbers.
• Strategy adoption, high-risk monitoring actions, and production changes require explicit human authority. Local adoption is not production deployment.
• Memory can suggest context or warn about a prior pitfall, but it cannot change KS, AUC, PSI, bad rate, score consistency, or any other deterministic result.
• Raw customer rows, full model files, PMML contents, credentials, private reports, and database connections are excluded from Agent memory.
• Code paths and CI are verified, but real-project acceptance still requires representative business materials, agreed metric definitions, independent reconciliation, and responsible-party sign-off.
• Current V2 is a local-first workbench. Full multi-user RBAC, production promotion/rollback, real-time decision-engine integration, and cross-device synchronization must not be inferred from the local workflow.

See the product roadmap for the precise current scope and V2 delivery boundary.

Quick start

Source installation supports Python 3.11–3.13; Python 3.12 is recommended for a new environment.

git clone https://github.com/eddyzzl/marvis-risk-agent.git
cd marvis-risk-agent
python -m venv .venv
source .venv/bin/activate
python -m pip install -U pip
python -m pip install -e .
marvis

Open http://127.0.0.1:8000/.

On Windows, activate the environment with .venv\Scripts\activate instead. When a release includes MARVIS-Setup-<version>-win-x64.exe, that asset provides the one-click local installer without requiring a separate Python, Java, Git, conda, WSL, or Docker installation.

PMML scoring requires a Java runtime compatible with pypmml. For material directory permissions, Windows drives, WSL paths, conda setup, upgrades, and deployment details, use the runbook.

To update a clean GitHub checkout:

marvis update

Product and operator documentation

• Roadmap — product scope, current V2 boundary, and workflow terminology
• Runbook — installation, startup, updates, material paths, and operations
• Notebook contract — model-validation Notebook runtime contract
• Notebook submission requirements — requirements for model developers
• Design — product experience and interface decisions
• Branding — local customer branding without source-code changes
• Versioning — release helper, versions, and tag rules
• Review evidence — implementation and code-review evidence

# Fast local feedback
scripts/check --fast

# Small, mapped changes
scripts/check --affected

# Full release gate
scripts/check

# Publish a verified patch release
python scripts/release_push.py --bump patch

Pull requests use parallel fast-test shards plus quality, security, strategy, and PMML gates. A manual CI dispatch runs the full, unfiltered release check.

License

MARVIS-Agent is released under the MIT License.