thatastral/argus

Argus is described as an AI-powered accountability wallet built on Monad, a blockchain network. The idea is that you commit real money toward a habit you want to keep, and a camera plus an AI model called Gemini checks whether you actually did the habit. If you keep it up, your committed funds stay yours. If you do not, a penalty system can take some of that stake. Your main wallet is never locked. Only the specific funds you choose to put toward a habit are controlled by the system. This repository is a scaffold, meaning it is an early, partial build rather than a finished product. It covers the core pieces described in a separate product document that is not included in this repository: a web app built with Next.js that provides both the interface and the backend logic, four smart contracts written for the blockchain that manage habits, wallets, and penalties, and a Supabase database used as a fast, readable cache for things like display names, proof images, and chat history. A mobile app built with React Native is planned but not yet started. To run it, you first deploy the smart contracts to a Monad test network, then set up a Supabase project and run its database migration, and finally configure the web app with the resulting contract addresses, database credentials, an API key for Gemini, and a couple of security keys. Logging in works only through a wallet signature, meaning you prove ownership of your crypto wallet rather than using an email or password. On the technical side, the blockchain contracts are the final source of truth for streaks, whether funds are locked or released, and where money moves, while Supabase exists only to make the app feel fast and to hold data that does not need to live on-chain. A scheduled daily job checks in on each habit's status, backed up by extra checks that run when users interact with the app. The visual design is kept deliberately simple, using only white, black, and grey with no gradients.