Gods Eye

Local-first evidence workspace for reviewing public investigation results.

Gods Eye helps investigators collect and review public profile signals across a broad set of web platforms. It keeps scans, reports, graph projections, and settings on the local machine. It does not turn graph proximity or correlation signals into an identity decision.

What it includes

• Browser workspace for new scans, activity, history, report comparison, watches, model tools, site maps, and MCP setup
• Evidence Graph with direct-evidence inspection, source URLs, confidence, platform cues, report deltas, minimap, focus controls, and browser-local layout preferences
• Found and Maybe verdicts, confidence scoring, public profile signals, domains, discoveries, and optional correlation output
• JSON, CSV, HTML, Markdown, PDF, GEXF, Mermaid, and Maltego exports
• Optional Playwright and Scrapling fallbacks for difficult public pages
• Local report storage and a loopback-only web server

Run locally

Windows workspace

Run the setup script once from the project root:

.\setup-web.bat

Then start the workspace:

.\launch-gods-eye.bat

It opens the local workspace at http://127.0.0.1:8765.

For development with frontend hot reload, run:

.\run-dev.bat

Source installation

git clone <your-repository-url> gods-eye
cd gods-eye
python -m venv .venv

Activate the environment, install the project with its web dependencies, then run gods-eye web. The Python module form is python -m gods_eye web.

Local handbook

The built Docusaurus handbook is served by the local app at http://127.0.0.1:8765/docs/. Its source lives in docs-site/.

cd docs-site
npm run start

Use npm run typecheck and npm run build before shipping handbook changes. The setup script installs and builds the handbook automatically.

Evidence Graph

The graph is a derived view of a completed local report. It shows only stored public evidence and direct evidence links. It can include accounts, variations, supplied identity hints, domains, discoveries, and report deltas, depending on the selected investigation lens and filters.

Use the graph to inspect evidence, not to make automatic claims that accounts belong to the same person. A link explains its source and strength in the inspector. Transitive clusters never become direct relationship meshes.

Project layout

• frontend/ contains the Vite and React browser workspace.
• src/ contains the Python scanner, report, graph, and local web services.
• tests/ contains backend and projection coverage.
• docs-site/ contains the Docusaurus operator and developer handbook.
• WORKING.md explains the runtime flow and module map.
• CHANGELOG.md records releases and notable changes.

Responsible use

Use Gods Eye only for legitimate research and in accordance with applicable law, platform terms, and the privacy rights of the people whose public data you review.

License

Copyright (C) 2026 Gods Eye.

Gods Eye is licensed under the GNU Affero General Public License v3.0. See LICENSE. The repository also retains required notices for source material incorporated under earlier permissive terms in NOTICE.

Maintainer

4kmal