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

[PR #570] [MERGED] feat: add AI Fraud Investigation Agent #4677

New Issue
Closed
opened 2026-05-12 07:40:53 -05:00 by GiteaMirror · 0 comments
GiteaMirror commented 2026-05-12 07:40:53 -05:00
Owner
Copy Link

📋 Pull Request Information

Original PR: https://github.com/Shubhamsaboo/awesome-llm-apps/pull/570
Author: @oso95
Created: 3/8/2026
Status: ✅ Merged
Merged: 3/17/2026
Merged by: @Shubhamsaboo

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

📝 Commits (10+)

  • 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
  • f8d68a0 fix: local testing fixes and demo polish
  • f509228 Update README for AI Fraud Investigation Agent
  • 762d654 Update package versions in requirements.txt

📊 Changes

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

View changed files

📝 README.md (+1 -0)
➕ advanced_ai_agents/single_agent_apps/ai_fraud_investigation_agent/README.md (+100 -0)
➕ advanced_ai_agents/single_agent_apps/ai_fraud_investigation_agent/fraud_investigation_agent.py (+935 -0)
➕ advanced_ai_agents/single_agent_apps/ai_fraud_investigation_agent/requirements.txt (+6 -0)

📄 Description

Summary

  • Adds advanced_ai_agents/single_agent_apps/ai_fraud_investigation_agent/ — a single-agent Streamlit app
  • Investigates licensed childcare providers by ZIP code using only public data: Illinois DCFS licensing, Cook County property records, Google Street View/Places, and IL Secretary of State business registration
  • First autonomous physical-evidence investigation agent in this repo
  • Built on Surelock Homes

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 open data
  3. Calculates maximum legal child capacity from IL building code math: (sqft × 0.65) ÷ 35
  4. Captures 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 it works

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

Tech stack

  • Framework: agno
  • LLM: OpenRouter (supports Claude, GPT, Gemini)
  • UI: Streamlit with streaming narration
  • Data: All public APIs, no auth required for property/DCFS data

Test plan

  • Install dependencies: pip install -r requirements.txt
  • Run: streamlit run fraud_investigation_agent.py
  • Enter an OpenRouter API key in the sidebar
  • Select a ZIP code (e.g. 60623) and click Investigate
  • Verify streaming narration appears and agent investigates providers

🔄 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/570 **Author:** [@oso95](https://github.com/oso95) **Created:** 3/8/2026 **Status:** ✅ Merged **Merged:** 3/17/2026 **Merged by:** [@Shubhamsaboo](https://github.com/Shubhamsaboo) **Base:** `main` ← **Head:** `add-ai-fraud-investigation-agent` --- ### 📝 Commits (10+) - [`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 - [`f8d68a0`](https://github.com/Shubhamsaboo/awesome-llm-apps/commit/f8d68a059d7981297800e1025a1e4a9a87eb0838) fix: local testing fixes and demo polish - [`f509228`](https://github.com/Shubhamsaboo/awesome-llm-apps/commit/f5092284fe9731ed76618b9f98af04242ccacc00) Update README for AI Fraud Investigation Agent - [`762d654`](https://github.com/Shubhamsaboo/awesome-llm-apps/commit/762d654fa31c3493d5e5deb919f7a7cf89636805) Update package versions in requirements.txt ### 📊 Changes **4 files changed** (+1042 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` (+100 -0) ➕ `advanced_ai_agents/single_agent_apps/ai_fraud_investigation_agent/fraud_investigation_agent.py` (+935 -0) ➕ `advanced_ai_agents/single_agent_apps/ai_fraud_investigation_agent/requirements.txt` (+6 -0) </details> ### 📄 Description ## Summary - Adds `advanced_ai_agents/single_agent_apps/ai_fraud_investigation_agent/` — a single-agent Streamlit app - Investigates licensed childcare providers by ZIP code using only public data: Illinois DCFS licensing, Cook County property records, Google Street View/Places, and IL Secretary of State business registration - First autonomous physical-evidence investigation agent in this repo - Built on [Surelock Homes](https://github.com/oso95/Surelock-Homes) ## 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 open data 3. Calculates maximum legal child capacity from IL building code math: `(sqft × 0.65) ÷ 35` 4. Captures 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 it works A 900 sq ft building cannot legally serve 50 children. This agent finds those mathematical impossibilities automatically. ## Tech stack - **Framework:** agno - **LLM:** OpenRouter (supports Claude, GPT, Gemini) - **UI:** Streamlit with streaming narration - **Data:** All public APIs, no auth required for property/DCFS data ## Test plan - [ ] Install dependencies: `pip install -r requirements.txt` - [ ] Run: `streamlit run fraud_investigation_agent.py` - [ ] Enter an OpenRouter API key in the sidebar - [ ] Select a ZIP code (e.g. `60623`) and click Investigate - [ ] Verify streaming narration appears and agent investigates providers --- <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-12 07:40:53 -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#4677
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?