README.md

---
title: Intelligent Search Engine (ISE)
emoji: 🔍
colorFrom: blue
colorTo: indigo
sdk: gradio
sdk_version: 5.7.1
app_file: app.py
pinned: false
---

# 🔍 Intelligent Search Engine (ISE)

An advanced OSINT search engine with RAG capabilities and multi-modal search features.

## 🌟 Features

### 🌐 Intelligent Search
- Web search with context understanding
- AI-powered answer synthesis
- Source citation and verification
- RAG-based knowledge retrieval

### 👤 OSINT Capabilities
- Username search across multiple platforms
- Person search (name, age, location)
- Social media profile exploration
- Personal information gathering
- Historical data retrieval

### 📸 Image Analysis
- Face detection and recognition
- Object and scene recognition
- Image metadata extraction
- Similar image search
- Cross-reference with social media

### 🗺️ Location Intelligence
- Geographic information analysis
- Location-based searching
- Address validation and normalization
- Proximity analysis

## 🛠️ Technology Stack

### Core Components
- Python 3.10+
- LangChain for RAG capabilities
- HuggingFace Transformers
- PyTorch (CPU optimized)
- Gradio for UI

### Search & Scraping
- DuckDuckGo Search
- Google Search Python
- BeautifulSoup4
- Requests/AIOHTTP

### OSINT Tools
- Holehe
- Sherlock Project
- Python WHOIS
- Geopy

### Image Processing
- Face Recognition
- Pillow
- Torchvision

## 📦 Installation

1. Clone the repository:
```bash
git clone https://github.com/yourusername/intelligent-search-engine.git
cd intelligent-search-engine
```

2. Install dependencies:
```bash
pip install -r requirements.txt
```

3. Run the application:
```bash
python app.py
```

## 🎯 Usage

### Web Interface
The application provides a user-friendly web interface with multiple tabs:

1. **Search Tab**
   - Enter your search query
   - Get AI-powered answers with sources

2. **Username Search Tab**
   - Search usernames across platforms
   - View consolidated social media presence

3. **Person Search Tab**
   - Search by name, location, age
   - Get comprehensive personal information

4. **Image Analysis Tab**
   - Upload images for analysis
   - Detect faces and objects
   - Search for similar images

## 🔒 Privacy & Security

- No sensitive data storage
- Anonymized result presentation
- Rate limiting for API calls
- Basic URL validation
- Secure data handling

## 🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Push to the branch
5. Create a Pull Request

## 📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

## ⚠️ Disclaimer

This tool is for educational and research purposes only. Users are responsible for complying with applicable laws and regulations regarding information gathering and privacy.