voidaccess README

README проекта с github.com/KatrielMoses/voidaccess. Одним файлом markdown: README.md.

VoidAccess: dark-web threat intel in your browser

Hosted at voidaccess.pro PyPI version Downloads GitHub stars License: MIT

Ask one question. Get a sourced report, a graph you can search, and IOCs you can load.
For security researchers, threat-intel teams, MSSPs and authorized investigators.

Use it hosted → voidaccess.pro  ·  Run it yourself → pip install voidaccess

An investigation on voidaccess.pro: the live view collects and filters dark-web results, then the results open as a searchable graph

Hosted, at voidaccess.pro

Skip the setup. Keep your distance.

The hosted version runs this engine for you. Searches and page fetches go out from our servers through Tor, so your research doesn't start from your laptop or office network. A live view shows every link found, kept or discarded (duplicates, 404s, timeouts, the safety filter), then the results open as a graph with every value searchable by category.

Start free at voidaccess.pro →

How it works

Ask, collect, filter, extract, deliver

One query fans out in parallel to 12+ Tor search engines, code hosts, security feeds and curated .onion seeds, then follows new .onion links as it finds them. Prohibited queries, URLs and content are dropped at mandatory safety gates. The full pipeline, with timeouts and recovery, is in Architecture.

What it finds

Category Examples
Threat actors Actor handles, ransomware groups, malware families, MITRE ATT&CK techniques
Infrastructure IPv4/IPv6, domains, URLs, .onion addresses, file hashes
Crypto wallets Bitcoin, Ethereum, Monero, Litecoin, Zcash, Solana, Tron and more
Credentials Cloud keys, tokens, JWTs, API keys, stealer-log and combo-list entries (masked)
Messaging Telegram, Discord, XMPP, Tox, Session, Matrix, Wire, ICQ, Wickr
Vulnerabilities CVEs, Exploit-DB IDs

Entities are linked into a relationship graph with communities and infrastructure clusters, and cross-referenced against earlier findings.

Nine export formats: STIX 2.1, MISP, Sigma, YARA, Snort, Suricata, CSV, JSON, Markdown

Run it yourself

Open source at the core. MIT.
pip install voidaccess
voidaccess configure                      # LLM provider, enrichment keys, Tor
voidaccess investigate "LockBit ransomware"
voidaccess export <id> --format stix     # stix, misp, sigma, yara, snort, suricata, package, csv, md, json

No Tor or LLM key yet? voidaccess investigate "LockBit ransomware" --no-llm --no-tor --depth shallow runs a clearnet-only pass. For the full stack (PostgreSQL, Tor, API and web UI) with Docker Compose, see the self-hosting guide. Python 3.10+.

CLI reference
Command Description
voidaccess investigate "QUERY" Run an investigation
voidaccess show Open the interactive entity browser
voidaccess export ID --format FORMAT Export as STIX, MISP, Sigma, YARA, Snort, Suricata, package, CSV, Markdown or JSON
voidaccess package ID Build an IOC package ZIP
voidaccess enrich ID Re-enrich a saved investigation
voidaccess list List saved investigations
voidaccess status Show configuration, Tor, cache, engine and seed status
voidaccess actors List persistent actor profiles
voidaccess actor HANDLE [--timeline] [--note "TEXT"] Show an actor, its timeline, or add a note
voidaccess configure [llm | keys | tor] Run the setup wizard, or one part of it
voidaccess version Print the installed version

Optional clearnet requests can use ScrapingAnt with --use-scraping-api or --use-proxies; Tor, .onion, GitHub and GitLab traffic are unaffected.

Sources and enrichment
Layer Sources
Dark-web search 12+ Tor search engines and curated .onion seeds
Open-web collection Paste sites, GitHub, GitLab and curated RSS feeds
Threat feeds AlienVault OTX, abuse.ch (MalwareBazaar, ThreatFox, URLhaus), CISA KEV
IP and domain context Shodan InternetDB, GreyNoise, AbuseIPDB, Feodo Tracker, crt.sh, URLScan.io, Wayback Machine, CIRCL PDNS, RDAP
File and identity context VirusTotal, Hybrid Analysis, Have I Been Pwned, EmailRep
Blockchain BlockCypher and Etherscan

Sources that need an API key are skipped cleanly without one. The hosted version uses a subset whose terms allow it. Full configuration: Architecture. For full sentence-transformer embeddings, pip install "voidaccess[nlp]"; without it, a deterministic fallback encoder is used.

LLM providers
Provider Typical models Notes
OpenRouter DeepSeek, Llama, Claude Default route; free models available
Groq Llama Fast hosted inference with a free tier
OpenAI GPT models API key required
Anthropic Claude Claude Haiku is the tested default
Google Gemini Gemini Flash and Pro Google AI Studio key required
Ollama Any installed local model Local, suitable for air-gapped deployments

voidaccess.pro · Self-hosting · Architecture · Contributing · Security · Usage policy · PyPI

License

MIT. Use VoidAccess only for authorized security research and threat-intelligence work; see the Usage Policy.

voidaccess (KatrielMoses/voidaccess)

Ищем в базе…

Что это такое?VoidAccess — самостоятельно развёртываемая платформа OSINT, которая превращает запросы для исследования даркнета в структурированные данные об угрозах с помощью 13-этапного конвейера: сбор, извлечение сущностей, обогащение, построение графа связей и экспорт. Позиционируется как бесплатная альтернатива Recorded Future, DarkOwl и Flare.
Это CLI-инструмент или веб-приложение?И то, и другое: его можно запустить локально как CLI с SQLite, а также как стек Docker Compose с PostgreSQL и веб-интерфейсом в браузере.
Как это запустить?Установите Python-пакет для локального CLI (на базе SQLite) и запустите мастер настройки, либо самостоятельно разверните полный стек (PostgreSQL, Tor, FastAPI, Next.js) через Docker Compose.
Для работы нужны Tor и ключ API для LLM?Для сбора данных нужен доступ к Tor, а для уточнения запросов и анализа — провайдер LLM. По умолчанию используется OpenRouter с бесплатными моделями, но можно подключить Groq, OpenAI, Anthropic, Google Gemini или локальную модель Ollama. Интеграции для обогащения данных, например Shodan или VirusTotal, просто пропускаются, если их API-ключи не настроены.
Можно ли бесплатно искать в даркнете что угодно?Нет. Обязательные фильтры безопасности контента проверяют запрещённые запросы, URL, материалы и извлечённые сущности на каждом этапе конвейера, а проект ограничивает использование авторизованными исследованиями в области безопасности согласно своей Политике использования.
Для кого это создано?Для специалистов по безопасности, команд по анализу киберугроз и других авторизованных исследователей, которым нужны сбор, обогащение, построение связей и экспорт в одном рабочем процессе.
Можно ли запускать это полностью изолированно от сети?Да. Поддерживается локальная модель Ollama для шага LLM, поэтому конвейер можно запускать без подключения к интернету. Без необязательных зависимостей PyTorch и sentence-transformer для эмбеддингов используется детерминированный кодировщик на основе SHA-256 вместо ошибки.
Какие сущности оно умеет извлекать?Адреса криптовалют, сетевые индикаторы (IP, домены, ссылки .onion, PGP-ключи), хеши файлов и семейства вредоносного ПО, утёкшие учётные данные и токены, никнеймы в мессенджерах, CVE и техники MITRE ATT&CK, контент для обнаружения, например правила YARA и Snort, а также личности субъектов угроз.
Какие форматы экспорта поддерживаются?Расследования можно экспортировать в STIX 2.1, MISP, Sigma, YARA, Snort, Suricata, CSV, Markdown или JSON, а через CLI — упаковать в ZIP-архив с пакетом IOC.
Запоминает ли система прошлые расследования и акторов?Да. Данные об акторах сохраняются: псевдонимы, инфраструктура, заметки, хронология и связи между расследованиями. Профили акторов можно просматривать и дополнять командами вроде voidaccess actor HANDLE --timeline.
Откуда на самом деле собираются данные из даркнета?Сбор ведётся параллельно из более чем 16 поисковых систем Tor и отобранных адресов .onion, а также из открытого веба: Pastebin, GitHub, GitLab и RSS-лент. Найденное затем сверяется с источниками данных об угрозах, такими как AlienVault OTX, abuse.ch и CISA KEV.
Какие есть похожие проекты?spiderfoot, web-check, flowsint, AiSOC, awesome-osint-arsenal, Shadowbroker, hackingtool, artex-global
Автор
KatrielMoses
Размер
40.3 MB
Звёзды
1.1K
Возраст
6 мес
Коммиты · 90 дней