J.A.R.V.I.S. : AUTONOMOUS TACTICAL OSINT SPECIALIST & INTELLIGENCE SYSTEM

Just A Rather Very Intelligent System — Autonomous OSINT Specialist & Intelligence Framework by Project Hellhound
An authoritative, multi-source OSINT intelligence powerhouse and tactical assistant. Equipped with deep target enumeration, multi-platform username scans (300+ services), identity pivoting, email verification, domain/WHOIS mapping, historical archives, breach telemetry, real-time ADS-B military flight tracking, keyless atmospheric telemetry, and 2D/3D topology graphing. J.A.R.V.I.S. doesn't just collect data—he cross-correlates, verifies, and delivers actionable, grounded investigative intelligence.

Quick Start · Installation & Setup · God's Eye Geointel · Settings Panel · OSINT Arsenal · AI Routing · Commands · Voice Engine · Desktop GUI · License

Note

🛡️ Authoritative OSINT Specialist & Intelligence Protocol

J.A.R.V.I.S. operates as an elite, autonomous OSINT specialist and intelligence officer. Drawing upon dozens of cross-referenced intelligence sources—from global domain infrastructure and social registries to real-time ADS-B airspace feeds and breach archives—he verifies and correlates findings before drawing conclusions. His analysis is delivered with refined British eloquence, dry wit, unflappable composure, and absolute factual grounding.

What Is This?

J.A.R.V.I.S. is an autonomous tactical OSINT specialist and personal intelligence framework developed by Project Hellhound. Built from the ground up for cybersecurity researchers, bug bounty hunters, CTF competitors, and intelligence operators, J.A.R.V.I.S. consolidates every phase of open-source reconnaissance into an automated, interactive workflow.

Why J.A.R.V.I.S. is an Authoritative OSINT Source

Unlike passive scrapers or noisy search wrappers, J.A.R.V.I.S. acts as a true intelligence analyst:

Multi-Vector Entity Pivoting: Transition seamlessly from an email address to a username, discover associated GitHub repositories, parse commit histories for developer identities, extract PGP keys, and uncover domain infrastructure.
Strict Anti-Hallucination Grounding: All verbal debriefs, monologues, and dossier exports are bound 100% to verified scan data recorded on the persistent blackboard. Zero fabricated usernames, zero invented endpoints.
Persistent Case Blackboard: Every target investigation creates an isolated, auditable workspace (cases/<target>/ and data/jarvis_memory.json) storing raw API outputs, normalized entity graphs, timestamped evidence notes, and exportable HTML dossiers.
Aerial & Infrastructure Telemetry: Integrated real-time military flight tracking (ADS-B), atmospheric weather intelligence, and public surveillance capabilities inspired by God's Eye View.

Operate across three flexible interfaces:

Desktop GUI Application: A dedicated PyWebView/FastAPI desktop interface featuring collapsible card modules, transparent eye API key toggles, 2D/3D radial topology graphs, and hands-free microphone input (jarvis).
Interactive Terminal: An interactive terminal environment with real-time monologue streaming, live progress feedback, and inline command execution (jarvis --cli).
Headless CLI Runner: Direct one-line command execution for automated scripts and headless task triggers (jarvis investigate <target>).

How It Works

You ──> jarvis ("Investigate target@domain.com") ──> Intent & Task Parser ──> Tactical Core
                                                            │                     │
                                                            ▼                     ▼
                                                 Personal Workflow       OSINT Recon Toolchain
                                                 ├─ Live Web Dorking     ├─ Sherlock & Maigret
                                                 ├─ Terminal Automation  ├─ Holehe & Gravatar
                                                 ├─ Tactical Telemetry   ├─ GitHub & Breach Checks
                                                 └─ Case Memory Core     └─ EXIF, WHOIS & DNS
                                                            │
                                                            ▼ (Correlates to Persistent Blackboard)
                                                 Jarvis Voice Engine <── Verification Guard
                                                            │            (Fish Audio / Local)
                                                            ▼
                                                 /export (Submission-Ready HTML Dossier)

All-in-One OSINT Capabilities: Deep target enumeration, domain profiling, breach checking, and system task automation.
Collapsible Card System: Settings, ledgers, and telemetry render in responsive card components with collapsible header toggles (▼ / ▶) and real-time status badges.
Eye Toggle Security: API key fields (Gemini, NVIDIA NIM, Fish Audio) feature transparent eye buttons (👁) for password visibility control.
Hands-Free Speech Input: Direct voice interaction paired with Spacebar push-to-talk and intelligent conversational streaming.
Interactive 2D/3D Topology Graphs: Guaranteed 2D SVG radial network fallback + 3D WebGL graph rendering connected target entities and skills.

The OSINT Specialist Arsenal

J.A.R.V.I.S. equips operators with a comprehensive multi-discipline reconnaissance arsenal:

Category	Module	Engine / Method	Capabilities
Identity & Accounts	`sherlock`	HTTP/Async Probe	Account discovery across 300+ social and developer platforms.
	`maigret`	Deep Metadata Parse	Identity aggregation, profile harvesting, and cross-site verification.
	`holehe`	Mail Endpoint Check	Checks email registration across 120+ web services without notifying targets.
	`gravatar`	Hash Lookup	Public avatar, bio, display name, and verified profile extraction.
Code & Developer	`github_recon`	GitHub Public API	Repository inspection, commit email trails, and SSH/PGP key harvesting.
Domain & Network	`dns_whois`	Socket / RDAP / DNS	Pulls A, AAAA, MX, TXT, CNAME, NS records, and registrar ownership.
	`wayback`	CDX Archive Index	Historic URL enumeration, forgotten subdomains, and historical snapshots.
Media & Geo	`exif_geo`	PIL / EXIF Parser	Extracts GPS coordinates, altitude, camera model, and timestamp metadata.
Threat & Reputation	`abuse_ipdb`	Threat Intelligence	Evaluates IP threat scores, ISP classification, and proxy/VPN exit nodes.
	`breach_directory`	Credential Telemetry	Discovers compromised account breaches and exposed data field classes.
Aerial & Telemetry	`adsb_radar`	Keyless ADS-B	Real-time military flight tracking, altitude, callsigns, and squawk codes.
	`atmospheric_intel`	Open-Meteo	Keyless real-time weather telemetry, cloud cover, and barometric pressure.
	`thermal_sensors`	NASA FIRMS	Real-time active wildfire and thermal satellite sensor anomalies (VIIRS/MODIS).
	`satellite_geointel`	CesiumJS / Ion	High-resolution 3D World Terrain, 3D OSM buildings, and orbital tracking.
Inference Acceleration	`groq_lpu`	Groq LPU Engine	Sub-100ms ultra-low-latency LLaMA 3.3 70B and Whisper audio transcription.
Visualization	`2d_3d_topology`	D3 / Three.js	Radial SVG relationship fallback + 3D WebGL entity topology graph.

🌍 God's Eye Geointel & 3D Satellite Reconnaissance

J.A.R.V.I.S. integrates the spatial intelligence architecture inspired by God's Eye View, delivering global situational awareness directly inside the spatial 3D WebGL viewport:

Keyless Global Intelligence (Works 100% Out of the Box)

Airspace Radar (ADS-B): Real-time military and commercial aircraft tracking worldwide via api.adsb.lol / airplanes.live. Single-click any contact for callsign, altitude, ground speed, Mach velocity, squawk code, and heading.
Flight Cockpit POV & Chase Mode: Lock onto any aircraft and experience first-person tactical cockpit perspective (LOCK AIRCRAFT) or third-person chase camera (CHASE TARGET).
Maritime Vessels (AIS): Worldwide commercial shipping and naval vessel locations with MMSI, vessel type, and heading indicators.
Tactical CCTV Grid: Live surveillance cones and simulated optical video feeds across key global metropolitan and tactical sector junctions.
Global Radio Scanner Tuner: 100% genuine live audio feeds from major international aviation towers (Tokyo Haneda ATC, Heathrow Tower ATC) and emergency dispatch channels (SF Police/Fire, BBC World Service).
USGS Planetary Seismic Monitor: Real-time earthquake monitoring ($M \ge 4.5$) with fault zone radius visualization and hypocenter depth telemetry.
Orbital Satellite Tracking: Live International Space Station (ISS) ephemeris tracking with nadir drop beam and 90-minute ground orbital track projection.
High-Resolution Satellite Imagery: Keyless ESRI World Imagery with OpenStreetMap fallback and photorealistic vibrance calibration.

⚙️ Settings Panel & Free API Configuration

J.A.R.V.I.S. includes a dedicated Settings Panel (⚙ button in the UI header or /settings) allowing operators to dynamically configure model endpoints, voice synthesis, and geointel providers without restarting the application:

┌─────────────────────────────────────────────────────────────┐
│                   J.A.R.V.I.S. — SETTINGS                   │
├─────────────────────────────────────────────────────────────┤
│ [LLM] Language Model Engine        [Ollama / Gemini / NIM]  │
│ [VOX] Fish Audio Voice Engine      [s2.1-pro-free / Vox ID] │
│ [GEO] God's Eye Geointel & Accel   [Cesium / NASA / Groq]   │
│ [RCN] Reconnaissance Modules       [Sherlock / Maigret...]  │
└─────────────────────────────────────────────────────────────┘

Unlocking Extra Capabilities with Free API Keys

All keys are optional. J.A.R.V.I.S. functions completely offline and keyless, but these free provider keys unlock immense extra analytical power:

Provider	Setting Field	Unlocked Capabilities	How to Get (100% Free)
Cesium Ion	`cesium_ion_token`	High-Resolution 3D World Terrain, 3D Photorealistic Tiles, and 3D OpenStreetMap Buildings.	ion.cesium.com/tokens
NASA FIRMS	`nasa_firms_key`	Real-time satellite active wildfire & thermal anomaly sensors (VIIRS NOAA-20, NOAA-21, Suomi-NPP).	firms.modaps.eosdis.nasa.gov/api/map_key/
Groq LPU	`groq_api_key`	Sub-100ms ultra-fast inference with `llama-3.3-70b-versatile` & Groq Whisper transcription (~800 tokens/sec).	console.groq.com/keys
NVIDIA NIM	`nvidia_api_key`	Frontier 70B–120B reasoning (`nvidia/nemotron-3-super-120b-a12b`, `meta/llama-3.3-70b`).	build.nvidia.com
Google Gemini	`gemini_api_key`	Multimodal vision analysis and deep entity correlation.	aistudio.google.com/apikey
Fish Audio	`fish_audio_api_key`	Ultra-realistic British tactical voice synthesis (`05b36da8574341d0803391491850db20`).	fish.audio/app/developers

🔑 Step-by-Step Guide to Acquiring Free API Keys

Operator keys can be configured instantly in the GUI via the Settings Panel (⚙ SETTINGS button in the top bar or via /settings in chat), or by editing config.yaml / .env:

1. Cesium Ion Access Token (`cesium_ion_token`)

What it unlocks: High-resolution 3D World Terrain elevation mesh, worldwide 3D photorealistic tiles, and 3D OpenStreetMap building models on the 3D globe.
Steps to obtain (100% Free):
1. Sign up for a free Community account at ion.cesium.com/signup.
2. Navigate to Access Tokens at ion.cesium.com/tokens.
3. Copy your default token (or generate a new token with assets:read permission).
4. In J.A.R.V.I.S., click ⚙ SETTINGS (or type /settings), paste into Cesium Ion Access Token, and click Save Settings.

2. NASA FIRMS MAP_KEY (`nasa_firms_key`)

What it unlocks: Live near-real-time satellite thermal anomaly detections and active wildfire hotspots across the globe (VIIRS NOAA-20, NOAA-21, and MODIS sensors).
Steps to obtain (100% Free):
1. Visit the NASA FIRMS MAP KEY portal: firms.modaps.eosdis.nasa.gov/api/map_key/.
2. Enter your email address and click Get MAP KEY.
3. NASA will immediately send your unique 32-character key to your inbox.
4. Paste into the NASA FIRMS MAP_KEY field in Settings and click Save Settings.

3. Groq LPU API Key (`groq_api_key`)

What it unlocks: Sub-100ms ultra-low-latency reasoning with llama-3.3-70b-versatile and accelerated voice transcription via Groq Whisper (~800 tokens/sec).
Steps to obtain (100% Free):
1. Go to the Groq Cloud Console at console.groq.com/keys.
2. Sign in with GitHub or Google.
3. Click Create API Key, enter a friendly name (e.g. JARVIS), and copy your key starting with gsk_.
4. Paste into the Groq LPU API Key field in Settings and click Save Settings.

4. NVIDIA NIM API Key (`nvidia_api_key`)

What it unlocks: Frontier-class 70B–120B reasoning engines (nvidia/nemotron-3-super-120b-a12b and meta/llama-3.3-70b-instruct).
Steps to obtain (100% Free):
1. Go to build.nvidia.com and log in.
2. Select nvidia/nemotron-3-super-120b-a12b or search for any Nemotron model.
3. Click Get API Key and generate your key (nvapi-...). NVIDIA provides generous free tier credits.
4. Paste into NVIDIA NIM API Key in Settings.

5. Google Gemini API Key (`gemini_api_key`)

What it unlocks: Multimodal image/screenshot analysis and deep entity correlation.
Steps to obtain (100% Free):
1. Head to Google AI Studio at aistudio.google.com/apikey.
2. Click Create API Key and select a Google Cloud project.
3. Copy your key (AIza...) and paste into Gemini API Key in Settings.

6. Fish Audio API Key (`fish_audio_api_key`)

What it unlocks: High-fidelity cloud voice synthesis with J.A.R.V.I.S. voice signature (05b36da8574341d0803391491850db20).
Steps to obtain (100% Free):
1. Visit fish.audio and register an account.
2. Go to the Developer Dashboard at fish.audio/app/developers.
3. Generate an API Key and paste it into Fish Audio API Key in Settings.

Tip

🔒 Dynamic Hot-Apply & Auto-Syncing

Whenever you save changes in the Settings Panel, J.A.R.V.I.S.:

Persists your keys directly into config.yaml.
Auto-syncs environment variables to the project .env file for sub-modules.
Hot-applies keys into active memory (Cesium.Ion.defaultAccessToken, cloud model router) immediately without requiring an application restart.

AI Model Routing & Recommended Providers

Autonomous intelligence gathering and personal assistant reasoning utilize fast SLMs and frontier LLMs for intent parsing and monologue synthesis.

Tip

💡 Recommended AI Engines

NVIDIA NIM (Strongly Recommended for Cloud): Use NVIDIA NIM (meta/llama-3.3-70b-instruct or nvidia/nemotron-3-super-120b-a12b). It is instant, ultra-fast, and provides generous free API credits for frontier-class 70B–120B reasoning at zero cost.
Local Qwen (Strongly Recommended for Offline): Run Qwen (qwen2.5:7b or qwen2.5:14b) locally via Ollama. Delivers exceptional local reasoning, structured output adherence, and 100% offline privacy with zero data leaving your machine.

🎙️ Voice Intelligence & Synthesis Engine

J.A.R.V.I.S. features high-fidelity, low-latency conversational speech powered by Fish Audio (Voice ID: 05b36da8574341d0803391491850db20) with automatic phrase caching and zero-shot local fallback (Chatterbox TTS).

🎧 Conversational Audio Protocol

Fish Audio Voice Engine: Configured out of the box with J.A.R.V.I.S. voice signature 05b36da8574341d0803391491850db20.
Pre-synthesized Tactical Audio Cache: Instant vocal responses for common system acknowledgments and telemetry updates.
Muting Guard: Ambient speech listening is automatically muted while J.A.R.V.I.S. is speaking to prevent self-triggering audio loops.

Installation & Setup

1. Requirements & Prerequisites

Operating System: Linux (Ubuntu, Debian, Kali, Arch), macOS.
Python: Version 3.10 or higher.
Dependencies: ffmpeg, espeak-ng (optional for local voice dataset generation).

2. Fast Deploy

Option A: One-Line Remote Installer

curl -fsSL https://raw.githubusercontent.com/project-hellhound-org/JARVIS/main/install.sh | bash

Option B: Standard Git Clone

git clone https://github.com/project-hellhound-org/JARVIS.git
cd JARVIS

# Initialize config from template
cp config.yaml.example config.yaml

# Run system installer
chmod +x install.sh
./install.sh

Reload Shell Environment

source ~/.bashrc   # or source ~/.zshrc

The automated installer will:

Set up an isolated Python environment (jarvis-env).
Initialize config.yaml from template configuration.
Install OSINT toolchains (sherlock, maigret, holehe, chatterbox-tts).
Mount desktop application dependencies (pywebview).
Register global jarvis command integration.

Quick Start

1. Native Desktop GUI App

Launch the desktop application with collapsible cards and interactive 2D/3D topology graph:

jarvis

2. Interactive Terminal

Launch the interactive CLI interface:

jarvis --cli

3. Headless Direct Command

Run a direct target investigation or assistant command:

jarvis investigate target@email.com
jarvis investigate johndoe_87
jarvis investigate target.com

Commands

All actions can be triggered via slash commands or natural language:

Core Commands

Command	Aliases	Description	Usage
`investigate`	`/investigate`, `stalk`	Run multi-pass OSINT sweep against a target	`investigate <target>`
`resume`	`/resume`, `load`	Open saved investigation case or task log	`resume <target>`
`pivot`	`/pivot`, `focus`	Pivot investigation on a discovered handle or IP	`pivot <entity>`
`cases`	`/cases`, `list`	List all archived cases and saved sessions	`cases`
`notes`	`/notes`, `add`	Append investigative note or task reminder	`notes <text>`
`export`	`/export`, `report`	Generate offline HTML investigation dossier	`export`
`help`	`/?`, `info`	Display command guide and available modules	`help`
`exit`	`quit`	Exit workspace	`exit`

Scope Policy & Legal Compliance

J.A.R.V.I.S. is built for authorized penetration testing, bug bounty programs, CTF challenges, educational intelligence gathering, and legitimate security research.

Always obtain explicit authorization before investigating external targets.
Users are solely responsible for ensuring compliance with all applicable local and international laws.

License

This project is licensed under the GNU General Public License v3 (GPLv3).

Acknowledgements & Inspirations

God's Eye View by Bilawal Sidhu (MIT License): Inspiring tactical airspace tracking, 3D trajectory traces, atmospheric weather telemetry, and real-time agentic loop methodologies. Tactical models and telemetry datasets are adapted and credited under their respective open-source licenses.

Author

_{Built with precision, intelligence, and absolute veracity. At your service, sir.}

Name		Name	Last commit message	Last commit date
assets		assets
core		core
exporters		exporters
frontend		frontend
gods_eye		gods_eye
modules		modules
narrative		narrative
tui		tui
.gitignore		.gitignore
DISCLAIMER.md		DISCLAIMER.md
LICENSE		LICENSE
README.md		README.md
config.yaml.example		config.yaml.example
install.sh		install.sh
jarvis.py		jarvis.py
listen_jarvis_voice.py		listen_jarvis_voice.py
requirements.txt		requirements.txt
setup.py		setup.py
update.sh		update.sh

Uh oh!

Latest commit

History

Folders and files

Repository files navigation

J.A.R.V.I.S. : AUTONOMOUS TACTICAL OSINT SPECIALIST & INTELLIGENCE SYSTEM

🛡️ Authoritative OSINT Specialist & Intelligence Protocol

What Is This?

Why J.A.R.V.I.S. is an Authoritative OSINT Source

How It Works

The OSINT Specialist Arsenal

🌍 God's Eye Geointel & 3D Satellite Reconnaissance

Keyless Global Intelligence (Works 100% Out of the Box)

⚙️ Settings Panel & Free API Configuration

Unlocking Extra Capabilities with Free API Keys

🔑 Step-by-Step Guide to Acquiring Free API Keys

1. Cesium Ion Access Token (cesium_ion_token)

2. NASA FIRMS MAP_KEY (nasa_firms_key)

3. Groq LPU API Key (groq_api_key)

4. NVIDIA NIM API Key (nvidia_api_key)

5. Google Gemini API Key (gemini_api_key)

6. Fish Audio API Key (fish_audio_api_key)