github-starred/awesome-llm-apps
2
0
Fork 0
mirror of https://github.com/Shubhamsaboo/awesome-llm-apps.git synced 2026-07-17 08:22:34 -05:00
Code Issues 136 Packages Projects Releases Wiki Activity

[PR #569] [CLOSED] feat: add AI Fraud Investigation Agent #6204

New Issue
Closed
opened 2026-05-27 22:56:03 -05:00 by GiteaMirror · 0 comments
GiteaMirror commented 2026-05-27 22:56:03 -05:00
Owner
Copy Link

📋 Pull Request Information

Original PR: https://github.com/Shubhamsaboo/awesome-llm-apps/pull/569
Author: @oso95
Created: 3/8/2026
Status: ❌ Closed

Base: main ← Head: add-ai-fraud-investigation-agent

📝 Commits (7)

  • ced4acb feat: add AI Fraud Investigation Agent
  • 0d99dc4 fix: critical runtime fixes for fraud investigation demo
  • 679e118 docs: update model ID in README to correct OpenRouter format
  • e07b534 fix: address remaining code review issues in demo
  • 8d7afdf feat: enable compress_tool_results to prevent context overflow on large investigations
  • bdaa556 fix: add missing state field to check_business_registration exception return
  • f3fc9e5 chore: remove unused base64 import and fix stale get_street_view docstring

📊 Changes

4 files changed (+1021 additions, -0 deletions)

View changed files

📝 README.md (+1 -0)
➕ advanced_ai_agents/single_agent_apps/ai_fraud_investigation_agent/README.md (+87 -0)
➕ advanced_ai_agents/single_agent_apps/ai_fraud_investigation_agent/fraud_investigation_agent.py (+928 -0)
➕ advanced_ai_agents/single_agent_apps/ai_fraud_investigation_agent/requirements.txt (+5 -0)

📄 Description

Summary

  • Adds advanced_ai_agents/single_agent_apps/ai_fraud_investigation_agent/ — a new single-agent Streamlit app
  • Investigates licensed childcare providers by ZIP code, cross-referencing public data (IL DCFS licensing, Cook County property records, Google Street View/Places, IL Secretary of State) to detect anomalies
  • No similar project exists in this repo — this is the first autonomous physical-evidence investigation agent
  • Built on Surelock Homes (open-source fraud investigation system)

What it does

  1. Queries Illinois DCFS for all active licensed childcare providers in a ZIP code
  2. Pulls building square footage from Cook County Assessor's open data
  3. Calculates maximum legal child capacity from IL building code math
  4. Fetches Google Street View images to visually verify the address
  5. Checks Google Places for current business status and reviews
  6. Verifies entity registration with Illinois Secretary of State
  7. Narrates the full investigation in real time — reasoning is visible as the agent works

A 900 sq ft building cannot legally serve 50 children. This tool finds those mathematical impossibilities automatically.

Tech stack

  • Framework: agno
  • LLM: OpenRouter (anthropic/claude-sonnet-4-20250514)
  • UI: Streamlit with streaming narration
  • Data: All public APIs, no auth required for property/DCFS data

Test plan

  • Clone repo and install requirements.txt
  • Set OPENROUTER_API_KEY (free tier sufficient)
  • Optionally set GOOGLE_MAPS_API_KEY
  • Run streamlit run fraud_investigation_agent.py
  • Enter a Chicago ZIP code (e.g. 60612) and click Investigate
  • Verify streaming narration appears and agent investigates providers

🤖 Generated with Claude Code

🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.

## 📋 Pull Request Information **Original PR:** https://github.com/Shubhamsaboo/awesome-llm-apps/pull/569 **Author:** [@oso95](https://github.com/oso95) **Created:** 3/8/2026 **Status:** ❌ Closed **Base:** `main` ← **Head:** `add-ai-fraud-investigation-agent` --- ### 📝 Commits (7) - [`ced4acb`](https://github.com/Shubhamsaboo/awesome-llm-apps/commit/ced4acba89d3d6cb4a646aca7ba65c69eb6081a9) feat: add AI Fraud Investigation Agent - [`0d99dc4`](https://github.com/Shubhamsaboo/awesome-llm-apps/commit/0d99dc4fc9596bd7c1e0b99af917a60b38e18f69) fix: critical runtime fixes for fraud investigation demo - [`679e118`](https://github.com/Shubhamsaboo/awesome-llm-apps/commit/679e1185f12d3380e3cc898f98cb2a00faf264f3) docs: update model ID in README to correct OpenRouter format - [`e07b534`](https://github.com/Shubhamsaboo/awesome-llm-apps/commit/e07b5342d2a27cf49c686abcca567df33c4c2ac8) fix: address remaining code review issues in demo - [`8d7afdf`](https://github.com/Shubhamsaboo/awesome-llm-apps/commit/8d7afdf913f5f51859507461efd972e32069a5f6) feat: enable compress_tool_results to prevent context overflow on large investigations - [`bdaa556`](https://github.com/Shubhamsaboo/awesome-llm-apps/commit/bdaa5569fcb628da4ee6de47a8aee6ada2069f67) fix: add missing state field to check_business_registration exception return - [`f3fc9e5`](https://github.com/Shubhamsaboo/awesome-llm-apps/commit/f3fc9e585c76c0868886354210a8c9208e64ca64) chore: remove unused base64 import and fix stale get_street_view docstring ### 📊 Changes **4 files changed** (+1021 additions, -0 deletions) <details> <summary>View changed files</summary> 📝 `README.md` (+1 -0) ➕ `advanced_ai_agents/single_agent_apps/ai_fraud_investigation_agent/README.md` (+87 -0) ➕ `advanced_ai_agents/single_agent_apps/ai_fraud_investigation_agent/fraud_investigation_agent.py` (+928 -0) ➕ `advanced_ai_agents/single_agent_apps/ai_fraud_investigation_agent/requirements.txt` (+5 -0) </details> ### 📄 Description ## Summary - Adds `advanced_ai_agents/single_agent_apps/ai_fraud_investigation_agent/` — a new single-agent Streamlit app - Investigates licensed childcare providers by ZIP code, cross-referencing **public data** (IL DCFS licensing, Cook County property records, Google Street View/Places, IL Secretary of State) to detect anomalies - **No similar project exists in this repo** — this is the first autonomous physical-evidence investigation agent - Built on [Surelock Homes](https://github.com/osobodev/Surelock-Homes) (open-source fraud investigation system) ## What it does 1. Queries Illinois DCFS for all active licensed childcare providers in a ZIP code 2. Pulls building square footage from Cook County Assessor's open data 3. Calculates maximum legal child capacity from IL building code math 4. Fetches Google Street View images to visually verify the address 5. Checks Google Places for current business status and reviews 6. Verifies entity registration with Illinois Secretary of State 7. Narrates the full investigation in real time — reasoning is visible as the agent works A 900 sq ft building cannot legally serve 50 children. This tool finds those mathematical impossibilities automatically. ## Tech stack - **Framework:** agno - **LLM:** OpenRouter (`anthropic/claude-sonnet-4-20250514`) - **UI:** Streamlit with streaming narration - **Data:** All public APIs, no auth required for property/DCFS data ## Test plan - [ ] Clone repo and install `requirements.txt` - [ ] Set `OPENROUTER_API_KEY` (free tier sufficient) - [ ] Optionally set `GOOGLE_MAPS_API_KEY` - [ ] Run `streamlit run fraud_investigation_agent.py` - [ ] Enter a Chicago ZIP code (e.g. `60612`) and click Investigate - [ ] Verify streaming narration appears and agent investigates providers 🤖 Generated with [Claude Code](https://claude.com/claude-code) --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
GiteaMirror added the pull-request label 2026-05-27 22:56:03 -05:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
bug
pull-request
Mirrored from GitHub Pull Request
No Label pull-request
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
GiteaMirror ninjasurge
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: github-starred/awesome-llm-apps#6204
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?