FindThemAI

AI-Powered Missing Person Identification Web App

---

🔹 Clone This Repository

git clone https://github.com/amugdg25/FindThemAI.git
cd FindThemAI

---

📌 Backend Setup

1️⃣ Install Required Dependencies (Linux)

sudo apt install postgresql postgresql-server-dev-all

2️⃣ Install pgvector Extension

cd /tmp
git clone --branch v0.8.0 https://github.com/pgvector/pgvector.git
cd pgvector
make
sudo make install

3️⃣ Set Up Python Virtual Environment

cd FindThemAI/backend
python -m venv venv
source venv/bin/activate  # Activate the virtual environment

4️⃣ Install Python Dependencies

pip install -r requirements.txt

---

🛠️ Database Configuration

5️⃣ Create a PostgreSQL Database

sudo -i -u postgres
psql

Run the following SQL commands inside psql:

CREATE USER alex WITH PASSWORD '12345';
CREATE DATABASE missing_persons_db OWNER alex;
\c missing_persons_db;
CREATE EXTENSION IF NOT EXISTS vector;

Restart PostgreSQL Service:

sudo systemctl restart postgresql

---

🔹 Initialize & Run the Backend

6️⃣ Initialize the Database (⚠️ This will reset the DB)

python init_db.py

7️⃣ Run the FastAPI Backend

uvicorn main:app --reload

---

🌐 API Endpoints

Endpoint	Description
http://127.0.0.1:8000/api/v1/	Root API Endpoint
http://127.0.0.1:8000/api/v1/register	Register a new user
http://127.0.0.1:8000/api/v1/token	Login and obtain JWT token
http://127.0.0.1:8000/api/v1/protected	Test protected routes
http://127.0.0.1:8000/api/v1/users	Fetch all users
http://127.0.0.1:8000/api/v1/users/<user_id>	Get a specific user
http://127.0.0.1:8000/api/v1/create-missing-person	Create a missing person report
http://127.0.0.1:8000/api/v1/missing-persons	Fetch all missing persons
http://127.0.0.1:8000/api/v1/missing-persons/<person_id>	Fetch a specific missing person
http://127.0.0.1:8000/api/v1/missing-persons/<person_id>/image	Fetch the missing person’s image
http://127.0.0.1:8000/api/v1/found-person	Search for a found person using facial recognition

---

🖥️ Frontend Setup

1️⃣ Navigate to Frontend

cd ../frontend

2️⃣ Install Dependencies

npm install

3️⃣ Start the Frontend

npm run dev

---

📸 Mockups of the Website

Here are some UI mockups demonstrating how the FindThemAI platform will look:

---

📢 Support & Feedback

🔗 Visit: [FindThemAI Website (Click here)]