Skip to content

CisnerosCodes/Scrap-Tech-Syndicate

Repository files navigation

ScrapTech Syndicate (STS)

Scan. Salvage. Sustain.

An AI-powered, cyberpunk-themed e-waste assessment tool designed to appraise discarded hardware, calculate environmental impact, and securely route tech to repair or recycling centers.

ScrapTech Syndicate turns your browser into a street-smart hardware fence. Whether you are holding a shattered phone, a stack of old motherboards, or an outdated laptop, STS uses AI vision and browser-spec scraping to give you an instant appraisal. It tells you what components to salvage, estimates carbon offset impact, and directs you to nearby drop-off or repair options.


Key Features

  • AI Hardware Scanner: Snap a picture of any tech using your device camera. The app uses Google Gemini Vision to identify the device, assess visible condition, and return a verdict: REVIVE, SALVAGE, or RECYCLE.
  • Browser Spec Jacking: Scan the current device without a camera by collecting browser-exposed signals like CPU threads, memory buckets, and GPU renderer strings.
  • Repair vs Replace Engine: Enter a hardware fault and compare estimated repair costs against replacement pricing, with a visual ROI indicator to help decide if it is worth saving.
  • Local Grid Map: Uses a dark, custom Leaflet map plus Google Places API results to geolocate and surface nearby repair shops or e-waste recycling locations.
  • Secure Data Sanitization Guides: Includes practical wipe and handoff guidance to reduce data leakage before device transfer.

How It Works Under the Hood

  1. The Appraisal Pipeline: A captured image is converted to base64 and posted to the Next.js API route at /api/scan.
  2. Strict AI Parsing: Gemini is configured to return JSON only, so the response can be validated and rendered reliably.
  3. Dynamic Routing: Based on verdict, frontend links users to map results focused on repair or recycling.
  4. Local Infrastructure: /api/places proxies Google Places API requests to avoid CORS issues and keep API keys server-side.

Tech Stack

  • Framework: Next.js 16 (App Router)
  • Language: TypeScript
  • Styling: Tailwind CSS v4 with custom inline theme and CRT-style visual effects
  • AI Integration: @google/generative-ai (Gemini Vision)
  • Mapping: react-leaflet and leaflet with CartoDB Dark Matter tiles

Getting Started

Prerequisites

  • Node.js 18+
  • A Gemini API key
  • A Google Maps API key with Places API (New) enabled

1. Clone the repository

git clone https://github.com/CisnerosCodes/Scrap-Tech-Syndicate.git
cd Scrap-Tech-Syndicate

2. Install dependencies

npm install

3. Set up environment variables

Create a .env.local file in the project root:

# Google Gemini Vision API key
GEMINI_API_KEY=your_gemini_api_key_here

# Google Places API key
MAPS_API_KEY=your_google_maps_api_key_here

4. Run the development server

npm run dev

Open http://localhost:3000 in your browser.


Project Structure

  • src/app/page.tsx: Main scanner interface, camera capture flow, and results rendering
  • src/app/map/page.tsx: Map page with client-only Leaflet integration
  • src/app/guide/page.tsx: Data wiping and security guidance
  • src/app/api/: API routes for Gemini scanning and Places proxying
  • src/components/: Shared UI components like Navbar, CRTOverlay, GlitchText, and MapView

License

This project is open source and available under the MIT License.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors