007-TheBond 🕵️‍♂️

🔍 Features

🚀 Installation & Usage

🐳 Method 1: Docker (Recommended)

Why Docker? Docker ensures consistent performance across all platforms and eliminates dependency issues.

# Pull the latest image
docker pull deadshot0x7/007-thebond:latest

# Run the tool interactively
docker run -it deadshot0x7/007-thebond:latest

# Run with volume mounting to save results
docker run -it -v $(pwd)/results:/app/results deadshot0x7/007-thebond:latest

Docker Compose (Optional):

version: '3.8'
services:
  osint-tool:
    image: deadshot0x7/007-thebond:latest
    stdin_open: true
    tty: true
    volumes:
      - ./results:/app/results
      - ./config:/app/config

🛠️ Method 2: Local Installation

Quick Setup Scripts:

For Linux/macOS:

git clone https://github.com/Deadshot0x7/007-TheBond.git
cd 007-TheBond
bash run_007-TheBond.sh

For Windows:

git clone https://github.com/Deadshot0x7/007-TheBond.git
cd 007-TheBond
run_007-TheBond.bat

🔧 Method 3: Manual Installation

# 1. Clone the repository
git clone https://github.com/Deadshot0x7/007-TheBond.git
cd 007-TheBond

# 2. Create and activate virtual environment
# Linux/macOS:
python3 -m venv venv
source venv/bin/activate

# Windows:
python -m venv venv
venv\Scripts\activate

# 3. Install requirements
pip install -r requirements.txt
# OR using uv (faster)
uv pip install -r requirements.txt

# 4. Run the script
cd scripts
python 007-TheBond.py

🖥️ Platform Compatibility

✅ Fully Tested & Working

⚠️ Limited Support

🚫 Non-Working Distros/Platforms

❌ These platforms are known to have critical issues:

📋 Prerequisites

For Native Installation:

• Python: 3.10 or higher
• Git: Latest version
• Internet Connection: Required for OSINT operations
• pip/uv: Package manager

For Docker Installation:

• Docker: 20.10+
• Docker Compose: 2.0+ (optional)
• 4GB RAM: Minimum recommended
• Internet Connection: Required

🛡️ Ethical Usage & Legal Disclaimer

⚠️ CRITICAL: This tool is designed for legitimate security research and educational purposes only.

✅ Authorized Uses:

• Educational and learning purposes
• Authorized penetration testing
• Security research with proper permissions
• OSINT investigations within legal boundaries
• Cybersecurity awareness training

❌ Prohibited Uses:

• Harassment, stalking, or intimidation
• Unauthorized surveillance
• Privacy violations
• Illegal data collection
• Corporate espionage
• Any activity violating local/international laws

📋 Legal Requirements:

• Always obtain explicit permission before investigating individuals
• Respect privacy laws in your jurisdiction (GDPR, CCPA, etc.)
• Use responsibly and within legal frameworks
• Document your authorization for security assessments

Disclaimer: The developer (@Deadshot0x7) assumes no responsibility for misuse of this tool. Users are solely responsible for ensuring legal and ethical compliance.

🔧 Configuration

Environment Variables:

# Optional configurations
export OSINT_OUTPUT_DIR="/path/to/results"
export OSINT_CONFIG_FILE="/path/to/config.json"
export PYTHONPATH="${PYTHONPATH}:/path/to/007-TheBond"

API Keys (Optional):

Some features may require API keys. Create a .env file:

HAVEIBEENPWNED_API_KEY=your_api_key_here
SHODAN_API_KEY=your_shodan_key

🐳 Docker Advantages

Why we recommend Docker:

📊 Usage Statistics

# Run with Docker
docker run -it deadshot0x7/007-thebond:latest

# Example session:
┌─────────────────────────────────────────┐
│         007-TheBond v3.0                │
│     OSINT Intelligence Toolkit         │
└─────────────────────────────────────────┘

[1] Instagram OSINT
[2] Phone Number OSINT  
[3] Username Search
[4] Web Search
[5] IP Lookup
[6] Email Lookup
[0] Exit

Select option: _

🤝 Contributing

We welcome contributions! Here's how:

🍴 Quick Contribution:

# 1. Fork the repository
# 2. Create feature branch
git checkout -b feature/AmazingFeature

# 3. Make changes and commit
git commit -m 'Add some AmazingFeature'

# 4. Push and create PR
git push origin feature/AmazingFeature

📋 Contribution Guidelines:

• Follow Python PEP 8 standards
• Add docstrings for new functions
• Test on multiple platforms
• Update README for new features
• Maintain ethical usage standards

🔍 Troubleshooting

Common Issues:

Issue: "Module not found"

# Solution: Use Docker
docker run -it deadshot0x7/007-thebond:latest

Issue: "Permission denied"

# Linux/macOS: Fix permissions
chmod +x run_007-TheBond.sh
# Or use Docker (recommended)

Issue: "Python version incompatible"

# Solution: Use Docker for consistent Python 3.10
docker run -it deadshot0x7/007-thebond:latest

📞 Support & Community

📜 License

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

🏆 Acknowledgments

• Security research community
• Open source contributors
• Ethical hackers worldwide
• All users providing feedback