Sous Audit

Sous Audit is a mobile-first accounts-payable reconciliation agent for independent restaurants. Built as an R&D prototype for the Build with Gemini XPRIZE, it uses Google Cloud services and the Gemini API to run a complete invoice reconciliation loop.

Project structure

This project is a TypeScript monorepo using npm workspaces:

sous-audit/
  apps/
    web/                  # Next.js mobile PWA
  services/
    agent-worker/         # Agent state machine and tool execution
    qbo-sync/             # QuickBooks Online sync service
  packages/
    shared/               # Shared schemas and reconciliation logic
  infra/                  # Deployment and infrastructure settings
  sample-data/            # Mock golden-test dataset

Core stack

• Frontend: Next.js PWA with responsive layouts.
• Backend: TypeScript and Node.js services designed for Cloud Run.
• Data: Firestore, Google Cloud Storage, and BigQuery.
• AI processing: Document AI Invoice Parser with Gemini for repair, normalization, and explanations.
• Observability: Cloud Logging and BigQuery audit views.

Local development

Requirements: Node.js 22+, npm 10+, and the Google Cloud SDK.

npm install
npm run dev:web
npm run dev:worker
npm run dev:qbo

Status

R&D prototype. The public repository contains the technical build and architecture. Submission planning and judge materials remain outside the public codebase.