Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Latest commit

Β 

History

46 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ” FaceSeek

A Flutter app that detects faces in photos and performs a reverse image search to find where those images appear on the web.

Flutter License Status Build In Public


⚠️ Ethical Use & Legal Disclaimer

Please read before using or contributing.

This project is built strictly for educational and personal use. By using this software, you agree to the following:

  • βœ… You may use this app to search for your own face/images
  • βœ… You may use this app for research, academic, or journalistic purposes with proper consent
  • βœ… You may search for publicly available images that you own the rights to
  • ❌ You may NOT use this app to identify, track, or surveil individuals without their explicit consent
  • ❌ You may NOT use this app to harass, stalk, doxx, or harm any person
  • ❌ You may NOT use this app in any way that violates applicable laws including but not limited to GDPR (EU), CCPA (California), PDPA, or any local privacy legislation in your jurisdiction

This tool does not store, collect, or transmit any biometric data. All face detection is performed on-device using Google ML Kit. Reverse image search is powered by third-party APIs and is subject to their respective terms of service.

The developer(s) of this project bear no responsibility for misuse of this software. Any use that violates the above terms is solely the responsibility of the end user.


🧠 How It Works

  1. User uploads or captures a photo
  2. On-device ML Kit detects and crops the face region
  3. The cropped face image is sent to a reverse image search API
  4. Results (URLs, thumbnails, source domains) are displayed in-app

πŸ› οΈ Tech Stack

Layer Technology
Mobile Framework Flutter 3.x
Face Detection Google ML Kit (on-device)
Reverse Image Search SerpAPI
State Management Riverpod
Storage Hive (local only)

πŸ“… Roadmap (100-Day Build in Public)

  • Day 1 β€” Project setup, basic UI scaffold
  • Day 2 β€” Camera integration
  • Day 3 β€” Gallery picker
  • Day 4-7 β€” ML Kit face detection
  • Day 8-12 β€” Face crop & preview
  • Day 13-20 β€” SerpAPI integration
  • Day 21-30 β€” Results display & history
  • Day 31-50 β€” Polish & edge cases
  • Day 51-75 β€” UI/UX improvements
  • Day 76-100 β€” Beta, launch, stores

πŸš€ Getting Started

Prerequisites

  • Flutter SDK >=3.0.0
  • Dart >=3.0.0
  • A SerpAPI key (free tier available)

Installation

git clone https://github.com/Parzival235/faceseek.git
cd faceseek
flutter pub get

Configuration

Create a .env file in the root:

SERP_API_KEY=your_api_key_here

⚠️ Never commit your .env file. It is already added to .gitignore.

Run

flutter run

🀝 Contributing

Contributions are welcome! Please read CONTRIBUTING.md and make sure your changes comply with the ethical use policy above.


πŸ“„ License

MIT License β€” see LICENSE for details.


πŸ‘€ Author

Built in public, one day at a time.

About

πŸ” Reverse face image search app

Resources

Contributing

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages