gitwtfhub

wtf is argus?

thatastral/argus — explained in plain English

Analysis updated 2026-05-18

0TypeScriptAudience · developerComplexity · 5/5Setup · hard

TL;DR

A crypto accountability app where you stake real funds on a habit and AI camera verification decides whether you keep your money or lose part of it as a penalty.

Mindmap

mindmap
  root((Argus))
    What it does
      Habit staking
      AI verification
      Penalty system
    Tech stack
      Next.js
      Solidity
      Supabase
    Use cases
      Habit accountability
      Wallet login
      Camera proof
    Audience
      Developers
      Web3 builders

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

Why would anyone build with this?

REASON 1

Prototype a smart contract system where users stake funds against personal habit goals.

REASON 2

Verify daily habit completion using a camera photo checked by an AI model.

REASON 3

Build a wallet-signature login flow instead of email or OAuth.

REASON 4

Learn how to structure a Next.js app with on-chain contracts and a Supabase cache layer.

What's in the stack?

TypeScriptNext.jsSoliditySupabaseMonad

How it stacks up

thatastral/argus0xkinno/astraea0xkinno/halcyon
Stars000
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyhardhardhard
Complexity5/54/54/5
Audiencedeveloperdeveloperdeveloper

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

How do you spin it up?

Difficulty · hard Time to first run · 1h+

Requires deploying smart contracts to the Monad testnet plus Supabase and Gemini API setup before the app runs.

Wtf does this do

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.

Yoink these prompts

Prompt 1
Help me deploy the Argus smart contracts to the Monad testnet using Foundry.
Prompt 2
Walk me through setting up the Supabase migration and storage bucket for Argus.
Prompt 3
Explain how Argus's wallet-signature login flow works end to end.
Prompt 4
Show me how to wire up the Gemini API key for photo-based habit verification in Argus.

Frequently asked questions

wtf is argus?

A crypto accountability app where you stake real funds on a habit and AI camera verification decides whether you keep your money or lose part of it as a penalty.

What language is argus written in?

Mainly TypeScript. The stack also includes TypeScript, Next.js, Solidity.

How hard is argus to set up?

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

Who is argus for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.