Update README.md with new features
🌍 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 Link
📝 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
🛰️ GeoSentinel Installation Guide
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
-
Earth View
https://127.0.0.1:8000/earth -
News Dashboard https://127.0.0.1:8000/news
🔒 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
🤖 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
📝 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
)
- News Dashboard
https://127.0.0.1:8000/news
✅ 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
📜 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
👥
X9 CYBERNETICS
Star History
If you use NeuroTumorNet in your research, please cite: Made with ❤️ and lots of ☕️.







