Skip to main content

VoidAccess logo

VoidAccess

License: MIT Python 3.10+ Docker Compose PyPI version PyPI downloads

Self-hostable OSINT for turning dark-web research queries into structured threat intelligence. Built for security researchers, threat-intelligence teams, and authorized investigators who need collection, enrichment, relationship mapping, and export in one workflow.

Terminal Output

VoidAccess

Quick Start

pip install voidaccess
voidaccess investigate "LockBit ransomware" --no-llm --no-tor --depth shallow
voidaccess list
voidaccess actors
voidaccess status

VoidAccess investigation demo

What It Does

  • Parallel collection - searches Tor indexes, paste sites, code forges, security feeds, and curated .onion seeds.
  • Entity extraction - finds IOCs, wallets, credentials, handles, vulnerabilities, actors, malware, people, and organizations.
  • Multi-source enrichment - adds reputation, breach, passive DNS, sandbox, blockchain, and threat-feed context.
  • Actor intelligence - persists aliases, infrastructure, notes, timelines, and cross-investigation relationships.
  • Relationship graphs - builds co-occurrence graphs, communities, paths, and infrastructure clusters.
  • Content safety - filters prohibited queries, URLs, content, and extracted entities at mandatory pipeline gates.
  • Structured exports - produces STIX 2.1, MISP, Sigma, YARA, Snort, Suricata, CSV, Markdown, JSON, and IOC packages.
  • CLI and web UI - runs locally with SQLite or as a Docker Compose stack with PostgreSQL and a browser interface.

Pipeline

Stage Action
1 Refine the investigation query with the selected LLM
2 Collect from Tor search, paste sites, code forges, RSS feeds, and curated seeds in parallel
3 Filter noisy or irrelevant pages
4 Enrich the query and early indicators from threat-intelligence sources
5 Discover additional .onion links recursively
6 Reuse recently processed pages from the vector cache
7 Fetch selected pages through Tor with response-size limits
8 Persist newly collected content
9 Merge collected and enriched intelligence
10 Extract entities with regex, NER, and optional LLM analysis
11 Cross-reference entities against historical and seed datasets
12 Build relationships, communities, and infrastructure clusters
13 Generate the final intelligence summary and export-ready result

Full pipeline behavior, timeouts, recovery, and data flow are documented in Architecture.

Entity Types

Category Examples
Cryptocurrency Bitcoin, Ethereum, Monero, Litecoin, Zcash, Solana, Tron, ENS
Network indicators IPv4, IPv6, domains, URLs, .onion addresses, MAC addresses, PGP keys
File indicators MD5, SHA-1, SHA-256, malware families
Credentials Cloud keys, tokens, JWTs, API keys, stealer logs, combo-list entries
Messaging Telegram, Discord, XMPP, Tox, Session, Matrix, Wire, ICQ, Wickr
Vulnerabilities CVEs, MITRE ATT&CK techniques and tactics, Exploit-DB IDs
Detection content YARA rules, Nuclei templates, Snort and Suricata indicators
Threat intelligence Actor handles, ransomware groups, paste links, people, organizations, locations

Collection and Enrichment

Layer Sources
Dark-web search 16+ Tor search engines and curated .onion seeds
Open-web collection Pastebin, dpaste, paste.ee, Rentry, GitHub, GitLab, and curated RSS feeds
Threat feeds AlienVault OTX, abuse.ch, MalwareBazaar, ThreatFox, URLhaus, ransomware.live, CISA KEV
IP and domain context Shodan InternetDB, GreyNoise, AbuseIPDB, Feodo Tracker, C2IntelFeeds, 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 API keys skip cleanly when their keys are absent. The complete key and configuration reference is in Architecture.

LLM Providers

Provider Typical models Notes
OpenRouter DeepSeek, Llama, Claude Default route; free models are 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 and suitable for air-gapped deployments

CLI Reference

Command Description
voidaccess investigate "QUERY" Run an investigation
voidaccess show Open the interactive entity browser
voidaccess export INVESTIGATION_ID --format FORMAT Export as STIX, MISP, Sigma, YARA, Snort, Suricata, package, CSV, Markdown, or JSON
voidaccess package INVESTIGATION_ID Build an IOC package ZIP
voidaccess enrich INVESTIGATION_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 Show an actor profile
voidaccess actor HANDLE --timeline Show an actor activity timeline
voidaccess actor HANDLE --note "TEXT" Add an analyst note to an actor profile
voidaccess timeline HANDLE Open an actor timeline directly
voidaccess configure Run the setup wizard
voidaccess configure llm Configure the LLM provider, model, and key
voidaccess configure keys Configure enrichment API keys
voidaccess configure tor Override the Tor proxy host and port
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.

Self-Hosting

Run the full PostgreSQL, Tor, FastAPI, and Next.js stack with Docker Compose. The self-hosting guide covers guided setup, environment configuration, operations, and troubleshooting.

Links

Self-hosting guide Docker Compose, environment setup, operations, and troubleshooting
Architecture Pipeline internals, modules, schema, API, enrichment, graph, and configuration reference
Contributing Development setup, standards, and pull requests
Security Supported versions and private vulnerability reporting
Usage policy Authorized-use requirements and prohibited activity
PyPI Published package and release files
GitHub Source, issues, and releases

License

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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

voidaccess-1.8.0.tar.gz (645.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

voidaccess-1.8.0-py3-none-any.whl (588.2 kB view details)

Uploaded Python 3

File details

Details for the file voidaccess-1.8.0.tar.gz.

File metadata

  • Download URL: voidaccess-1.8.0.tar.gz
  • Upload date:
  • Size: 645.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.10.6

File hashes

Hashes for voidaccess-1.8.0.tar.gz
Algorithm Hash digest
SHA256 de2d18051a3db9da1e3494bd866d38c75f36405761843de91ff6b27c32b40276
MD5 5c80ab5851a4ba5ce43bb84c2a12fe88
BLAKE2b-256 c4a7482d21eb6ff039f778649cc0bf640a4a99eb8ea022ce48b21ac0fc24e941

See more details on using hashes here.

File details

Details for the file voidaccess-1.8.0-py3-none-any.whl.

File metadata

  • Download URL: voidaccess-1.8.0-py3-none-any.whl
  • Upload date:
  • Size: 588.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.10.6

File hashes

Hashes for voidaccess-1.8.0-py3-none-any.whl
Algorithm Hash digest
SHA256 23e499047a5e1b71c3fbf7a9de6390d7816dd6d57c0680b3da339996a385703f
MD5 db24c54584f5edf196453fe85960985f
BLAKE2b-256 97f9890ed884d999e94a3272ed2e6fd5a970578846680a1cf6eda86e39b48df5

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page