google-labs-jules[bot] 8f921fbeac Finalize README.md with comprehensive API list and features
- Added all integrated APIs to the "🙏 API TO USE" section.
- Ensured all new features (Darkweb, Web Scraper, GeoSential AI) are documented in Features and API Endpoints.
- Verified functionality with verify_search.py.

Co-authored-by: haybnzz <67865621+haybnzz@users.noreply.github.com>
2026-02-09 13:49:37 +00:00
2026-01-30 03:17:53 +05:30
2026-02-09 18:36:54 +05:30
2026-01-17 01:18:55 +05:30
2026-01-17 01:12:34 +05:30
2026-02-09 18:53:16 +05:30
2026-02-09 18:48:12 +05:30

🌍 GeoSentinel

Python Linux Tests GeoSentinel

GeoSentinel

GeoSentinel is a geospatial monitoring platform that tracks global movement in real time.

It aggregates ship and flight routes, live coordinates, and geodata into a unified system, providing clear geographic and geopolitical awareness for analysis, visualization, and decision-making. . 🚀

🚀 Visit the Blog:
👉 https://haybnz.web.app/blog

🚀 Visit the Blog:
👉 https://varadaraj.online/


🔴 NOTE
Stay updated with the latest Geo Sentinel AI releases and announcements.

👉 Subscribe here:
https://docs.google.com/forms/d/e/1FAIpQLSe3qBh6r1orih2MkLf5DjdolX0jv5Abct02363lLxpXEute-Q/viewform

🌟 Features

  • 🗺️ Access to GeoJSON data and surveillance grid tiles.
  • ✈️ Real-time flight data.
  • 🚢 Live vessel tracking.
  • 🛰️ Advanced aerial segmentation with YOLO.
  • 🖼️ Image analysis for object and GPS metadata.
  • 📰 Geopolitical news and sentiment analysis.
  • 💹 Market data for commodities and cryptocurrencies.
  • 🌐 Translation services.
  • 🔒 TOR integration for enhanced privacy.
  • 🤖 OLLAMA AI integration for local LLM processing.
  • 🕵️‍♂️ Darkweb Search: Anonymous searching across multiple .onion engines via TOR integration.
  • 🔍 Advanced Web Scraper: Multi-engine OSINT search with Google Dorking for social media platforms (Twitter, Reddit, Instagram, etc.).
  • 🤖 GeoSential AI: Intelligent assistant for automated real-time tracking of flights and vessels with integrated OSINT.

🌍 Earth HTML Features

  • Interactive global map with real-time tracking
  • Advanced search capabilities (HEX, flight, vessel, coordinates)
  • TomTom Maps API integration for detailed mapping
  • Activity logging and user tracking
  • Responsive design for all devices
  • GPS metadata extraction from images
  • Real-time data visualization
  • Integrated GeoSential AI for automated tracking and analysis
  • Advanced web scanning with social media dorking capabilities

📦 Download and Move geodata Folder to Root Directory

👉 Download geodata folder

-ADD API KEY IN app.py -ADD API KEY IN earth.html {on line1850 const tomtomApiKey = 'ADD_API+KEY';}

🛰️ GeoSentinel Installation Guide

📥 Clone or Fork the Repository

Option 1: Clone directly

git clone https://github.com/h9zdev/GeoSentinel.git

Option 2: Fork the repository

https://github.com/h9zdev/GeoSentinel/fork

Then clone your fork:

git clone https://github.com/<your-username>/GeoSentinel.git

📂 Navigate to Project Directory

cd GeoSentinel

🧩 Install Dependencies

pip install -r requirements.txt

(Optional but recommended)

python -m venv venv
source venv/bin/activate   # Linux / macOS
venv\Scripts\activate      # Windows

▶️ Run the Application

python app.py

🌐 Open in Browser


🔒 TOR Installation & Setup (Linux)

Option 1: Install TOR from Package Manager

# Ubuntu/Debian
sudo apt-get update
sudo apt-get install tor torbrowser-launcher -y

# Fedora/RHEL
sudo dnf install tor torbrowser-launcher -y

Option 2: Install TOR from Source

# Download TOR
cd /tmp
wget https://archive.torproject.org/tor-package-archive/tor-latest.tar.gz
tar -xzf tor-latest.tar.gz
cd tor-*

# Compile and install
./configure
make
sudo make install

Start TOR Service

# Start TOR daemon
sudo systemctl start tor
sudo systemctl enable tor  # Enable on boot

# Or run manually
tor

# Verify TOR is running
curl --socks5 127.0.0.1:9050 https://check.torproject.org/api/ip

Configure TOR in GeoSentinel

Add to your Python code for TOR support:

import requests
from requests.adapters import HTTPAdapter
from stem import Signal
from stem.control import Controller

# SOCKS5 proxy configuration
proxies = {
    'http': 'socks5://127.0.0.1:9050',
    'https': 'socks5://127.0.0.1:9050'
}

# Make request through TOR
response = requests.get('https://api.example.com', proxies=proxies)

🤖 OLLAMA Installation & Setup

Installation Steps

Step 1: Download OLLAMA

# macOS
curl -fsSL https://ollama.ai/install.sh | sh

# Linux
curl -fsSL https://ollama.ai/install.sh | sh

# Or download from
https://ollama.ai/download

Step 2: Verify Installation

ollama --version

Step 3: Pull a Model

# Pull Llama 2 model (7B parameters)
ollama pull llama2

# Or pull other models
ollama pull mistral      # Mistral model
ollama pull neural-chat  # Neural Chat model
ollama pull orca-mini    # Orca Mini model

Step 4: Run OLLAMA Server

# Start OLLAMA server (runs on localhost:11434)
ollama serve

Step 5: Test OLLAMA

# In another terminal, test the API
curl http://localhost:11434/api/generate -d '{
  "model": "llama2",
  "prompt": "Why is the sky blue?"
}'

Python Integration with GeoSentinel

import requests
import json

def query_ollama(prompt, model="llama2"):
    """Query OLLAMA local LLM"""
    url = "http://localhost:11434/api/generate"

    payload = {
        "model": model,
        "prompt": prompt,
        "stream": False
    }

    response = requests.post(url, json=payload)
    if response.status_code == 200:
        return response.json()['response']
    return None

# Usage example
response = query_ollama("Analyze the geopolitical implications of...")
print(response)

Common OLLAMA Commands

# List installed models
ollama list

# Remove a model
ollama rm llama2

# Run model interactively
ollama run llama2

# Set custom parameters
ollama run llama2 --temperature 0.5 --top_k 10

📝 Configuration

API Keys Required

  • TomTom Maps API: Add your key in templates/earth.html (line ~1850)

    const tomtomApiKey = 'YOUR_TOMTOM_API_KEY';
    
  • Other APIs: Add relevant API keys in app.py


🚀 Advanced Usage

With TOR + OLLAMA

import requests
from stem.control import Controller
import json

# Configure TOR
proxies = {
    'http': 'socks5://127.0.0.1:9050',
    'https': 'socks5://127.0.0.1:9050'
}

# Query OLLAMA through TOR (for privacy-focused analysis)
response = requests.post(
    'http://localhost:11434/api/generate',
    json={"model": "llama2", "prompt": "Analyze geopolitical data"},
    proxies=proxies,
    timeout=30
)


Notes

  • SSL warnings are normal for localhost with HTTPS.
  • Use http://127.0.0.1:8000 if HTTPS is not configured.

⚙️ API Endpoints

🌎 Earth

  • GET /earth
    • Renders the main earth page.

🗺️ GeoJSON

  • GET /api/geojson/
    • Retrieves a summary of a GeoJSON file.
    • Example: /api/geojson/example.geojson

🛰️ Surveillance Grid

  • GET /api/geo/index
    • Retrieves the surveillance grid index.
  • GET /api/geo/tile///
    • Retrieves a specific surveillance grid tile.
    • Example: /api/geo/tile/1/2/3

✈️ Flights

  • GET /api/geo/flights
    • Fetches live flight data.
  • GET /api/geo/flight/meta/
    • Retrieves metadata for a specific flight.
    • Example: /api/geo/flight/meta/UAL123

🚢 Vessels

  • GET /api/geo/vessels
    • Fetches live vessel data.
  • GET /api/geo/vessel/path/
    • Retrieves the historical path of a vessel.
    • Example: /api/geo/vessel/path/123456789

📸 Image Analysis

  • POST /api/geo/segment
    • Performs aerial segmentation on a satellite tile.
  • POST /api/geo/analyze-upload or /upload
    • Analyzes an uploaded image for objects and GPS metadata.

📰 News

  • GET /api/geo/news
    • Fetches geopolitical news for a specific location.
  • POST /api/news/analyze
    • Analyzes the sentiment of a news article.
  • GET /api/news/advanced
    • Performs an advanced search for news articles.

💹 Market

  • GET /api/market/data
    • Fetches market data for commodities and cryptocurrencies.

🌐 Translate

  • GET /api/translate
    • Translates text to English.

🔍 Web Scraper

  • POST /api/tools/web_scan
    • Advanced web scanning with multi-engine support and Google Dorking.
    • Parameters: query, type (text/images/all), sources (list of sites), aggressive (boolean).

🤖 GeoSential AI

  • POST /api/geosentialai/chat
    • Chat with the AI assistant for geospatial analysis and real-time data.
    • Parameters: message, web_search (boolean), human_mode (boolean), engine (cloud/local), context (map state).

🚀 How to Use

curl http://localhost:8000/api/geo/flights

🙏 API TO USE

🗺️ Images of GeoSentinel UI

GeoSentinel Screenshot GeoSentinel Screenshot

GeoSentinel Screenshot

GeoSentinel Screenshot

GeoSentinel Screenshot GeoSentinel Screenshot

GeoSentinel Screenshot

📜 License

This project is licensed under the Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0) License. See the LICENSE file for more details.

Unauthorized use is strictly prohibited.

📧 Contact: singularat@protn.me

Support

Donate via Monero: 45PU6txuLxtFFcVP95qT2xXdg7eZzPsqFfbtZp5HTjLbPquDAugBKNSh1bJ76qmAWNGMBCKk4R1UCYqXxYwYfP2wTggZNhq

👥 Contributors and Developers

haybnzz
Steiynbrodt
H9yzz
VaradScript

👥

X9 CYBERNETICS

Star History

Star History Chart

If you use NeuroTumorNet in your research, please cite: Made with ❤️ and lots of .

Description
Mirrored from GitHub
Readme 11 MiB
Languages
HTML 74.8%
Python 25.2%