GroundTruth-AI-dev / README.md
grixelle's picture
Update README.md
8d52ffd verified
metadata
title: GroundTruth
emoji: 🏠
colorFrom: blue
colorTo: blue
sdk: docker
sdk_version: 5.16.0
app_port: 7860
app_file: app.py
pinned: true
license: apache-2.0
tags:
  - real-estate
  - spatial-reasoning
  - robotics-ai
  - gemini-api
  - proptech

GroundTruth: Temporal Property Sentinel

A High-Fidelity Spatial Reasoning Engine for Real Estate Analysis

Project Overview

GroundTruth is an analytical platform designed to provide "Spatial Truth" in property valuation and assessment. By utilizing the Google Gemini Robotics-ER 1.5 model, this application moves beyond standard object detection to perform forensic, multi-period structural audits.

Why Robotics-ER 1.5?

Standard Vision-Language Models (VLMs) are trained to identify what is in an image (e.g., "a house with a lawn"). GroundTruth uses the Robotics-ER 1.5 API because it is specifically optimized for Embodied Reasoning—the ability to understand physical structure, depth, and spatial relationships as they unfold across time.

Key Technical Advantages:

  • Spatial Accuracy: Outperforms standard models (like Gemini Flash) in 3D detection and precise pointing tasks, which is critical for identifying specific structural defects like roof sagging or foundation cracks.
  • Temporal Reasoning: Natively understands cause-and-effect relationships and sequences of events. It doesn't just see two photos; it reasons about the maintenance trajectory between them.
  • Physical World Logic: Trained on robotic interaction data, the model understands "affordances"—the physical possibilities of a space (e.g., whether a wall is likely load-bearing based on its position).

Features

  • Side-by-Side Forensic Audit: Compare historical and present-day imagery to identify capital improvements or systemic neglect.
  • Maintenance Trajectory Scoring: Automated classification of a property as "Improving," "Stable," or "Declining" based on visual structural evidence.
  • High-Budget Thinking: Utilizes the model's tunable thinking budget to prioritize forensic accuracy over simple latency for complex structural questions.

Intended Use

  • Real Estate Agents: Automating "Pride of Ownership" reports for listing presentations.
  • Investors: Remote due diligence and asset condition monitoring over time.
  • Compliance Officers: Identifying unauthorized additions or zoning violations via historical imagery comparison.

Limitations & Disclaimers

  • Vision-Only: Analysis is based on exterior visual data; it cannot "see" internal structural integrity or hidden plumbing/electrical issues.
  • Safety: While optimized for physical reasoning, all AI outputs should be verified by a licensed human inspector before financial or safety decisions are made.

License

This project is licensed under the Apache License 2.0, providing explicit patent protection and commercial flexibility for the Real Estate tech ecosystem.


Created by Evan Bench — Google AI Architect