{"id":"7c36198f-269c-4bac-86eb-527a5b88740f","entityType":"agent","slug":"crewai-jhonhtipas21-balancr","name":"Balancr","canonicalUrl":"https://www.xpersona.co/agent/crewai-jhonhtipas21-balancr","canonicalPath":"/agent/crewai-jhonhtipas21-balancr","generatedAt":"2026-10-09T20:11:27.972Z","source":"GITHUB_REPOS","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-09T11:50:37.113Z","emptyReason":null},"description":"Agent (LangGraph/CrewAI) that reads transactions, detects anomalies, crosses disbursements and generates reports without human intervention. BalanCR Monorepo hosting two cohabiting pieces: 1. **BalanCR antifraud MVP** (apps/, ml/, scripts/, docs/): the academic project this README introduces. FastAPI + Postgres backend, Next.js dashboard, XGBoost + Isolation Forest inference with SHAP explanations, hash-chained audit trail, synthetic sandbox for beta testers. 2. **Legacy reconciliation engine** (balancr/, tests/, evals/, data/, reports/, .github/workflows","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. Last updated 10/9/2026.","installCommand":null,"sourceUrl":"https://github.com/JhonHTipas21/Balancr","homepage":null,"primaryLinks":[{"label":"View Source","url":"https://github.com/JhonHTipas21/Balancr","kind":"source"}],"safetyScore":66,"overallRank":34.6,"popularityScore":0,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Agent (LangGraph/CrewAI) that reads transactions, detects anomalies, crosses disbursements and generates reports without human intervention. BalanCR Monorepo ho"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-09T11:50:37.113Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[{"label":"crewai","status":"self-declared"},{"label":"multi-agent","status":"self-declared"}],"verifiedCount":0,"selfDeclaredCount":3,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"},{"key":"crewai","type":"capability","support":"supported","confidenceSource":"profile","notes":"Declared in agent profile metadata"},{"key":"multi-agent","type":"capability","support":"supported","confidenceSource":"profile","notes":"Declared in agent profile metadata"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile capability:crewai|supported|profile capability:multi-agent|supported|profile"}},"adoption":{"evidence":{"source":"no-adoption-signals","verified":false,"confidence":"low","updatedAt":"2026-10-09T11:50:37.113Z","emptyReason":"No source adoption metrics were available."},"stars":0,"forks":0,"downloads":null,"packageName":null,"latestVersion":null,"tractionLabel":null},"release":{"evidence":{"source":"agent-index","verified":false,"confidence":"medium","updatedAt":"2026-10-09T11:50:37.106Z","emptyReason":null},"lastUpdatedAt":"2026-10-09T11:50:37.113Z","lastCrawledAt":"2026-10-09T11:50:37.106Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-16T11:50:37.106Z","lastVerifiedAt":null,"highlights":[]},"execution":{"evidence":{"source":"GITHUB REPOS","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":null,"setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/crewai-jhonhtipas21-balancr/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/crewai-jhonhtipas21-balancr/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/crewai-jhonhtipas21-balancr/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/crewai-jhonhtipas21-balancr/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/crewai-jhonhtipas21-balancr/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/crewai-jhonhtipas21-balancr/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"GITHUB_REPOS","generatedAt":"2026-10-09T20:11:27.971Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/crewai-jhonhtipas21-balancr/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/crewai-jhonhtipas21-balancr/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/crewai-jhonhtipas21-balancr/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/crewai-jhonhtipas21-balancr/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"GITHUB REPOS","verified":false,"confidence":"high","updatedAt":"2026-10-09T11:50:37.113Z","emptyReason":null},"readme":"# BalanCR\n\nMonorepo hosting two cohabiting pieces:\n\n1. **BalanCR antifraud MVP** (`apps/`, `ml/`, `scripts/`, `docs/`): the\n   academic project this README introduces. FastAPI + Postgres backend,\n   Next.js dashboard, XGBoost + Isolation Forest inference with SHAP\n   explanations, hash-chained audit trail, synthetic sandbox for beta\n   testers.\n2. **Legacy reconciliation engine** (`balancr/`, `tests/`, `evals/`,\n   `data/`, `reports/`, `.github/workflows/agent-eval.yml`): preserved\n   unchanged per\n   [`docs/decisions/0001-reconciliation-engine-fate.md`](docs/decisions/0001-reconciliation-engine-fate.md).\n   Documented in the \"Legacy reconciliation engine\" section below.\n\nEverything in group 1 is the subject of the academic deliverable. Group\n2 keeps working in its own domain and is not touched by the MVP code.\n\n## Antifraud MVP at a glance\n\n- **API**: `apps/api` (Python 3.11, FastAPI, SQLAlchemy 2.x, Alembic).\n  Endpoints under `/api/v1`.\n- **Web**: `apps/web` (Next.js 15, TypeScript, Tailwind, dark mode).\n- **ML**: deterministic synthetic generator + reproducible training\n  pipeline under `ml/`. Artifacts in `ml/artifacts/<version>/`\n  (gitignored).\n- **Scripts**: `scripts/{train_models,evaluate_models,verify_audit_chain,simulate_transactions}.py`.\n- **Database**: PostgreSQL 16 via Docker Compose; schema in\n  `apps/api/migrations/versions/`.\n\n## Quickstart\n\n```bash\ndocker compose up -d postgres api web\n\n# migrate the schema\ncd apps/api && pip install -e \".[dev]\"\nBALANCR_DATABASE_URL=postgresql+psycopg://balancr:balancr@localhost:5432/balancr_fraud \\\n    alembic -c alembic.ini upgrade head\n\n# train + promote the models (synthetic data; see docs/model-cards/)\ncd ../..\nBALANCR_DATABASE_URL=postgresql+psycopg://balancr:balancr@localhost:5432/balancr_fraud \\\n    python scripts/train_models.py --version 0.1.0 --seed 42 --n 10000 --promote\n\n# evaluate\nBALANCR_DATABASE_URL=postgresql+psycopg://balancr:balancr@localhost:5432/balancr_fraud \\\n    python scripts/evaluate_models.py --seed 7 --n 2000\n\n# open the dashboard\nopen http://localhost:3000\n```\n\nSee [`docs/demo-script-mvp.md`](docs/demo-script-mvp.md) for the\n15-minute walkthrough.\n\n## Repository layout\n\n```\napps/\n├── api/          FastAPI backend + Alembic migrations + pytest suite\n├── web/          Next.js 15 dashboard with /sandbox tester route\nml/\n├── data/         Deterministic synthetic generator\n├── training/     Training pipeline (XGBoost + Isolation Forest)\n├── evaluation/   Evaluation helpers\n└── artifacts/    Trained artifacts (gitignored)\nscripts/\n├── train_models.py         Train + register + optionally promote\n├── evaluate_models.py       Evaluate active models + emit JSON report\n├── verify_audit_chain.py    CLI integrity check for audit_events\n└── simulate_transactions.py Submit sandbox scenarios from the terminal\ndocs/\n├── architecture/            Architecture decisions, final diagram\n├── audit/                   Current state audit\n├── decisions/               ADR 0001..0006 (canonical)\n├── governance/              AI policy, roles, risk register, lifecycle,\n│                            shadow validation, retraining policy\n├── model-cards/             Real metrics for the shipped models\n├── sandbox/                 Architecture, scenarios, testing guide\n├── validation/              Dataset card + evaluation reports\n└── requirements/            Traceability matrix (canonical)\nbalancr/        Legacy reconciliation engine (preserved; see ADR 0001)\n```\n\n## Documentation entry points\n\n- [`docs/architecture/mvp-architecture.md`](docs/architecture/mvp-architecture.md)\n- [`docs/governance/ai-policy.md`](docs/governance/ai-policy.md)\n- [`docs/governance/roles-and-responsibilities.md`](docs/governance/roles-and-responsibilities.md)\n- [`docs/governance/ai-risk-register.md`](docs/governance/ai-risk-register.md)\n- [`docs/model-cards/`](docs/model-cards/) and\n  [`docs/validation/dataset-card.md`](docs/validation/dataset-card.md)\n- [`docs/sandbox/architecture.md`](docs/sandbox/architecture.md),\n  [`docs/sandbox/scenarios.md`](docs/sandbox/scenarios.md),\n  [`docs/sandbox/testing-guide.md`](docs/sandbox/testing-guide.md)\n- [`docs/decisions/`](docs/decisions/) — six ADRs (0001..0006)\n- [`docs/requirements/traceability-matrix.md`](docs/requirements/traceability-matrix.md)\n- [`docs/demo-script-mvp.md`](docs/demo-script-mvp.md)\n\n## CI\n\nTwo GitHub Actions workflows run on PR and push:\n\n- `.github/workflows/mvp-ci.yml` (antifraud MVP):\n  - Quality gate: `ruff check`, `ruff format --check`, `mypy app`\n    (strict).\n  - Tests + Alembic upgrade head against a real Postgres service.\n  - Audit chain seed + `scripts/verify_audit_chain.py`.\n  - End-to-end `scripts/train_models.py --promote` +\n    `scripts/evaluate_models.py` smoke.\n  - Web: `tsc --noEmit`, `next lint`, `next build` (standalone).\n- `.github/workflows/agent-eval.yml` (legacy reconciliation): untouched;\n  continues to protect the reconciliation agent.\n\n## Legacy reconciliation engine (preserved)\n\nThe code under `balancr/`, `tests/`, `evals/`, `data/`, `reports/`,\n`.agents/skills/{reconciliation-engine,agent-eval-ci,git-commit-policy}`\nand `.github/workflows/agent-eval.yml` implements the earlier version of\nBalanCR — a continuous payment reconciliation agent. ADR-0001 decided\nto preserve it intact alongside the new MVP. Its documentation and\nquickstart live in that section of the repository history and are not\naffected by the antifraud work.\n\nOriginal README of that project (for traceability):\n\n> BalanCR is an autonomous agent for continuous payment reconciliation.\n> It matches transactions across payment gateways, bank statements, and\n> internal ledgers using deterministic algorithms and LLM-powered\n> anomaly classification. The reconciliation docs (`balancr/`,\n> `tests/`, `evals/`) describe its features: three-way matching, LLM\n> anomaly classification via LangGraph + Groq, vector memory via\n> ChromaDB, Markdown/PDF reports, and the embedded SPA dashboard. The\n> golden-case evaluation pipeline enforces a minimum accuracy\n> threshold on every PR via `.github/workflows/agent-eval.yml`.\n\nFor anything specifically related to the reconciliation engine, see the\nfiles above. The antifraud MVP never imports from `balancr/` and never\nalters the reconciliation workflow.\n\n## License\n\nMIT. See [`LICENSE`](LICENSE).\n","readmeExcerpt":"BalanCR Monorepo hosting two cohabiting pieces: 1. **BalanCR antifraud MVP** (apps/, ml/, scripts/, docs/): the academic project this README introduces. FastAPI + Postgres backend, Next.js dashboard, XGBoost + Isolation Forest inference with SHAP explanations, hash-chained audit trail, synthetic sandbox for beta testers. 2. **Legacy reconciliation engine** (balancr/, tests/, evals/, data/, reports/, .github/workflows","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"docker compose up -d postgres api web\n\n# migrate the schema\ncd apps/api && pip install -e \".[dev]\"\nBALANCR_DATABASE_URL=postgresql+psycopg://balancr:balancr@localhost:5432/balancr_fraud \\\n    alembic -c alembic.ini upgrade head\n\n# train + promote the models (synthetic data; see docs/model-cards/)\ncd ../..\nBALANCR_DATABASE_URL=postgresql+psycopg://balancr:balancr@localhost:5432/balancr_fraud \\\n    python scripts/train_models.py --version 0.1.0 --seed 42 --n 10000 --promote\n\n# evaluate\nBALANCR_DATABASE_URL=postgresql+psycopg://balancr:balancr@localhost:5432/balancr_fraud \\\n    python scripts/evaluate_models.py --seed 7 --n 2000\n\n# open the dashboard\nopen http://localhost:3000"},{"language":"text","snippet":"apps/\n├── api/          FastAPI backend + Alembic migrations + pytest suite\n├── web/          Next.js 15 dashboard with /sandbox tester route\nml/\n├── data/         Deterministic synthetic generator\n├── training/     Training pipeline (XGBoost + Isolation Forest)\n├── evaluation/   Evaluation helpers\n└── artifacts/    Trained artifacts (gitignored)\nscripts/\n├── train_models.py         Train + register + optionally promote\n├── evaluate_models.py       Evaluate active models + emit JSON report\n├── verify_audit_chain.py    CLI integrity check for audit_events\n└── simulate_transactions.py Submit sandbox scenarios from the terminal\ndocs/\n├── architecture/            Architecture decisions, final diagram\n├── audit/                   Current state audit\n├── decisions/               ADR 0001..0006 (canonical)\n├── governance/              AI policy, roles, risk register, lifecycle,\n│                            shadow validation, retraining policy\n├── model-cards/             Real metrics for the shipped models\n├── sandbox/                 Architecture, scenarios, testing guide\n├── validation/              Dataset card + evaluation reports\n└── requirements/            Traceability matrix (canonical)\nbalancr/        Legacy reconciliation engine (preserved; see ADR 0001)"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[],"languages":["python"],"docsSourceLabel":"GITHUB REPOS","editorialOverview":"Agent (LangGraph/CrewAI) that reads transactions, detects anomalies, crosses disbursements and generates reports without human intervention. BalanCR Monorepo hosting two cohabiting pieces: 1. **BalanCR antifraud MVP** (apps/, ml/, scripts/, docs/): the academic project this README introduces. FastAPI + Postgres backend, Next.js dashboard, XGBoost + Isolation Forest inference with SHAP explanations, hash-chained audit trail, synthetic sandbox for beta testers. 2. **Legacy reconciliation engine** (balancr/, tests/, evals/, data/, reports/, .github/workflows","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":359,"uniquenessScore":75,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-09T11:50:37.113Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-09T11:50:37.113Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-09T20:11:27.972Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/github_repos","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}