Skip to content

antsuh1028/PocketZot

Repository files navigation

PocketZot | IrvineHacks 2026 Winner!

Chrome Extension (Manifest V3) with a Shimeji-style anteater mascot that walks around on AI chat sites (ChatGPT, Claude, Gemini, Perplexity), plus a React popup and FastAPI backend.

Features

  • Anteater mascot — Walks around the page, can be dragged and thrown (Will steal your mouse occaisionally)
  • Shop — Buy hats (Plunger, Cracked Egg, Crown, and Christmas Hat) with the ants you collect
  • Login / Sign up — Email-based auth for data saving
  • Prompt classification — LLM rates your prompts; mascot reacts (good/bad)
  • Ants & health — Earn ants for good prompts, spend in shop

Structure

PocketZot/
├── manifest.json          # Extension metadata, popup, content scripts
├── background.js          # Service worker (EQUIP_HAT, classify, health)
├── anteaterchar/          # Content script mascot (physics, sprite, drag)
│   ├── anteater.js
│   ├── sprite.js
│   ├── messageListener.js
│   └── assets/
├── frontend/              # React popup (Vite)
│   ├── pocket_zot.html
│   ├── src/App.jsx
│   └── src/pages/
├── backend/               # FastAPI
│   ├── src/main.py
│   ├── src/api/           # users, anteaters, accessories, classifier
│   └── schema/            # SQL migrations
└── dist/                  # Built output (popup + anteaterchar)

Frontend (React) setup

  1. Install dependencies:

    npm install
  2. Build the popup and copy content scripts:

    npm run build

    This builds the popup to dist/ and copies anteaterchar/ into dist/anteaterchar/.

Backend (FastAPI) setup

  1. Create and activate a Python virtual environment.

  2. Install dependencies:

    pip install -r backend/requirements.txt
  3. Set up PostgreSQL and create a .env file with DATABASE_URL.

  4. Run migrations:

    python backend/scripts/run_migration.py
  5. Start the API server:

    uvicorn backend.src.main:app --reload

    API docs: http://127.0.0.1:8000/docs

Load the extension

  1. Open Chrome and go to chrome://extensions.
  2. Enable Developer mode.
  3. Click Load unpacked.
  4. Select the PocketZot folder (the one with manifest.json).
  5. Click the PocketZot icon to open the popup.

After code changes, run npm run build and click Reload on the extension card.

Content script sites

The anteater mascot runs on:

  • https://chatgpt.com/*
  • https://claude.ai/*
  • https://gemini.google.com/*
  • https://*.perplexity.ai/*

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors