git404hub

what is vigil-auditor fr?

uiansol/vigil-auditor — explained in plain English

Analysis updated 2026-05-18

0GoAudience · developerComplexity · 4/5Setup · hard

tl;dr

Vigil is an in-progress tool that scans uploaded bank statements to find hidden subscriptions and billing creep without sending raw data to a bank aggregator.

vibe map

mindmap
  root((vigil auditor))
    What it does
      Scans bank statements
      Finds hidden subscriptions
      Detects billing creep
    Privacy approach
      In-memory processing
      Redacts account numbers
      No raw upload storage
    Tech stack
      Go gateway
      Python AI service
      Next.js frontend
    Use cases
      Run demo with Docker
      Study redaction pattern
      Extend parsing logic

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Run the Docker Compose demo to upload a sample bank statement and see the planned audit flow in action.

VIBE 2

Study the Go gateway's in-memory redaction approach as an example of stripping PII before an AI processing step.

VIBE 3

Use the project's gRPC contract between the Go gateway and Python service as a reference for a similar multi-language architecture.

VIBE 4

Extend the Python auditor service to add real CSV parsing or subscription detection logic beyond the current demo stub.

what's the stack?

GoPythonNext.jsReactPostgreSQLDocker

how it stacks up fr

uiansol/vigil-auditor42wim/fabio42wim/go-xmpp
Stars0
LanguageGoGoGo
Last pushed2018-02-042020-01-24
MaintenanceDormantDormant
Setup difficultyhardmoderatemoderate
Complexity4/53/53/5
Audiencedeveloperops devopsdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · hard time til it works · 1h+

Requires Go, Python 3.12+, Node.js, and Docker Compose to bring up the gateway, AI service, database, and frontend together.

in plain english

Vigil is a project that aims to help people find and cancel forgotten subscriptions and creeping charges by analyzing their bank statements. Instead of connecting to a bank account through a third party aggregator service, a user uploads a raw PDF or CSV bank statement, and Vigil looks for hidden subscriptions, bills that quietly increase over time, and free trials that turned into paid charges without the user noticing. It also includes a planned cancellation feature meant to walk a user through the steps needed to cancel an unwanted service, including direct links where possible. The project's stated priority is privacy. Uploaded statements are streamed in memory rather than written to disk, and the system strips out sensitive details like account numbers before any data is sent to an AI model, so only merchant names are used for further processing. The README states that raw uploads are not saved in this first version of the project. Under the hood, Vigil is split into a few pieces working together. A Go based gateway service handles file uploads, session cookies, and streams progress updates back to the browser as the audit runs. A separate Python service handles the actual parsing and analysis, matching similar merchant names together and detecting billing creep, with a plan to use a locally run AI model in a later stage of development. A Next.js and React frontend gives users a dashboard to upload files and watch the audit progress live, and PostgreSQL stores session and audit data. This is an early stage, in progress project. The current slice of work supports uploading a file and seeing a staged demo progress bar, while real statement parsing is planned for a later slice. Running it requires Go, Python, Node.js, and Docker with Docker Compose to bring up all the services together, or a hybrid setup running the backend in Docker and the frontend directly on your machine. The README does not state a license.

prompts (copy fr)

prompt 1
Walk me through setting up this project locally with Docker Compose and running the CLI upload demo.
prompt 2
Explain how this project redacts personal information from a bank statement before sending data to an AI model.
prompt 3
Explain the architecture split between the Go gateway, the Python auditor service, and the Next.js frontend.
prompt 4
Help me regenerate the gRPC protobuf stubs used between the gateway and the AI service.

Frequently asked questions

what is vigil-auditor fr?

Vigil is an in-progress tool that scans uploaded bank statements to find hidden subscriptions and billing creep without sending raw data to a bank aggregator.

What language is vigil-auditor written in?

Mainly Go. The stack also includes Go, Python, Next.js.

How hard is vigil-auditor to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is vigil-auditor for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.