Configuration

Standalone config file

Provider and model choices persist in:

~/.bughunter/config.json

Written by bughunter setup / bughunter init with mode 0600. Rerunning the standalone installer preserves this file. Uninstall keeps it unless you pass --purge-config.

Provider setup

bughunter setup
bughunter setup --provider ollama --model qwen2.5:14b

One-off overrides (do not rewrite saved config):

bughunter --provider groq --model llama-3.3-70b-versatile hunt target.com
# or:
export BRAIN_PROVIDER=ollama
export BRAIN_MODEL=qwen2.5:14b

Auto-detect order (when nothing is forced): Ollama → Groq → DeepSeek → … → OrcaRouter → OpenRouter → Claude → OpenAI. LiteLLM is opt-in (selected explicitly or when LITELLM_API_KEY is set) so it does not preempt a configured provider.

Common env vars

Variable	Provider
`GROQ_API_KEY`	Groq
`DEEPSEEK_API_KEY`	DeepSeek
`ANTHROPIC_API_KEY`	Claude
`OPENAI_API_KEY`	OpenAI
`XAI_API_KEY`	Grok (xAI)
`OPENROUTER_API_KEY`	OpenRouter
`ORCAROUTER_API_KEY`	OrcaRouter
`LITELLM_API_KEY` / `LITELLM_API_BASE`	LiteLLM proxy (opt-in)
`BRAIN_PROVIDER`	Force provider
`BRAIN_MODEL`	Force model
`CHAOS_API_KEY`	ProjectDiscovery Chaos (recon)

Keys saved in ~/.bughunter/config.json are loaded into the environment when the matching env var is unset.

Hunt / tool template

Repo template: config.example.json. Copy and fill only what you need:

{
  "chaos_api_key": "YOUR_PROJECTDISCOVERY_CHAOS_API_KEY",
  "h1_api_token": "YOUR_HACKERONE_API_TOKEN",
  "output_dir": "./findings",
  "recon_dir": "./recon",
  "reports_dir": "./reports",
  "nuclei_severity": ["critical", "high", "medium"],
  "katana_depth": 3,
  "ffuf_threads": 40,
  "interactsh_server": "oast.pro",
  "models": {
    "ollama": "qwen2.5:14b"
  }
}

Do not commit real tokens. Prefer env vars for secrets where possible.

MCP approval

Active MCP tools need approval. Client config can set:

{
  "env": {
    "BBHUNT_MCP_APPROVE": "0"
  }
}

Use approve=true on the tool call, or set BBHUNT_MCP_APPROVE=1, for active testing. See MCP.

Get started

Research

Integrate

Help

Standalone config file

Provider setup

Common env vars

Hunt / tool template

MCP approval

​Standalone config file

​Provider setup

​Common env vars

​Hunt / tool template

​MCP approval

​Related

Standalone config file

Provider setup

Common env vars

Hunt / tool template

MCP approval

Related