https://github.com/edycutjong/qguard

🔒 Air-Gapped AI Wallet Security Auditor — Built for Colosseum Frontier Hackathon
https://github.com/edycutjong/qguard

ai frontier hackathon local-first nextjs qvac solana tether wallet-security

Last synced: 1 day ago
JSON representation

🔒 Air-Gapped AI Wallet Security Auditor — Built for Colosseum Frontier Hackathon

• Host: GitHub
• URL: https://github.com/edycutjong/qguard
• Owner: edycutjong
• License: mit
• Created: 2026-05-10T12:44:44.000Z (about 1 month ago)
• Default Branch: main
• Last Pushed: 2026-05-10T15:33:28.000Z (about 1 month ago)
• Last Synced: 2026-05-10T16:05:50.212Z (about 1 month ago)
• Topics: ai, frontier, hackathon, local-first, nextjs, qvac, solana, tether, wallet-security
• Language: TypeScript
• Homepage: https://qguard.edycu.dev
• Size: 4.2 MB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Agents: AGENTS.md

Awesome Lists containing this project

README

          


  
Qguard 🚀

  
Air-Gapped AI Wallet Security Auditor. Local-first wallet guardian using all 4 QVAC features.

  

  

  


  

  [![Live Demo](https://img.shields.io/badge/Live-Demo-brightgreen.svg?style=for-the-badge)](https://qguard.edycu.dev)

  [![Pitch Deck](https://img.shields.io/badge/Pitch-Deck-f59e0b.svg?style=for-the-badge)](https://qguard.edycu.dev/pitch)

  [![Pitch Video](https://img.shields.io/badge/Pitch-Video-red.svg?style=for-the-badge)](https://youtu.be/1dnF1fC-r40)

  [![Superteam Earn](https://img.shields.io/badge/Superteam-Earn_Listing-blue.svg?style=for-the-badge)](https://superteam.fun/earn/listing/tether-frontier-hackathon-track)


  


  ![Next.js](https://img.shields.io/badge/Next.js-000000?style=flat&logo=next.js&logoColor=white)

  ![React](https://img.shields.io/badge/React-20232A?style=flat&logo=react&logoColor=61DAFB)

  ![Tailwind CSS](https://img.shields.io/badge/Tailwind_CSS-38B2AC?style=flat&logo=tailwind-css&logoColor=white)

  ![TypeScript](https://img.shields.io/badge/TypeScript-007ACC?style=flat&logo=typescript&logoColor=white)

  [![Qguard CI](https://github.com/edycutjong/qguard/actions/workflows/ci.yml/badge.svg)](https://github.com/edycutjong/qguard/actions/workflows/ci.yml)



---

## 📸 See it in Action

*(Demo GIF and UI screenshots can be found in the `docs/assets` directory)*

[**▶️ Watch the Demo Video**](https://youtu.be/1dnF1fC-r40)



  



## 💡 The Problem & Solution

Local-first wallet guardian using all 4 QVAC features: LLM risk scoring, RAG security advisories, OCR receipt matching, STT voice queries — zero cloud.

**Qguard** solves this by providing: 

Local-first wallet guardian using all 4 QVAC features: LLM risk scoring, RAG security advisories, OCR receipt matching, STT voice queries — zero cloud.

**Key Features:**

- ⚡ **High Performance:** Seamless integration and optimized workflows.

- 🔒 **Secure by Design:** Verifiable on-chain actions and robust data protection.

- 🎨 **Intuitive UX:** Beautiful, user-centric interface built for scale.

## 🏗️ Architecture & Tech Stack

### Tech Stack

| Component | Technology | Description |

|-----------|------------|-------------|

| **Frontend** | Next.js 16, React 19 | App Router, SSR, Server Components |

| **Styling** | Tailwind CSS v4 | High-performance responsive UI |

| **Language** | TypeScript | Strict type safety across the stack |

| **Testing** | Vitest | Comprehensive unit and component testing |

For a detailed breakdown of our system architecture and data flow, please refer to the [Architecture Document](docs/ARCHITECTURE.md).

## 🏆 Sponsor Tracks Targeted

* **Sponsor Integration**: (Check `docs/SPONSOR_DEFENSE.md` for our full sponsor integration strategy)

## 🚀 Run it Locally (For Judges)

1. **Clone the repo:** `git clone https://github.com/edycutjong/qguard.git`

2. **Install dependencies:** `npm install`

3. **Set up environment variables:**

   ```bash

   cp .env.example .env.local

   ```

   *Note: Add your keys to the `.env.local` file. You can obtain a `QVAC_API_KEY` from the [Tether account settings](https://app.tether.to/app/account/settings/api-keys).*

4. **Run the app:** `npm run dev`

> **Note for Judges:** 

> Detailed demo scripts and sponsor defenses are located in the `docs/` directory.

> Read `docs/SPONSOR_DEFENSE.md` for technical implementation details.

---

## 📄 License

This project is licensed under the [MIT License](LICENSE).