docs(llm): document Atomic Agents refactor, new default model, wordlist mode (2.12.0)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Justin Bollinger
2026-07-24 12:11:26 -04:00
co-authored by Claude Opus 4.8
parent bcea02b2e7
commit 519d395708
2 changed files with 27 additions and 4 deletions
+21
View File
@@ -7,6 +7,27 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
Dates are omitted for releases predating this file; see the git tags for exact timing.
## [2.12.0] - 2026-07-24
### Changed
- **LLM attack now uses the Atomic Agents framework** for structured (JSON) candidate
generation instead of raw HTTP + regex line-parsing. Candidate generation lives in the
new `hate_crack/llm.py` module.
- **Default Ollama model is now `qwen2.5:32b`** (was `mistral`), chosen for reliable
structured-output adherence.
### Added
- **Wordlist (denylist) generation mode** for the LLM attack is now reachable from the
menu: select the LLM attack (option 12), then choose "Wordlist" to derive basewords from
a sample wordlist.
### Removed
- **Automatic model pulling.** hate_crack no longer pulls missing Ollama models; pull them
yourself with `ollama pull <model>`.
## [2.11.3] - 2026-07-24
### Fixed
+6 -4
View File
@@ -459,18 +459,20 @@ Set Hashview credentials in `config.json`:
#### Ollama Configuration
The LLM Attack (option 15) uses Ollama to generate password candidates. Configure the model and context window in `config.json`:
The LLM Attack (option 12) uses Ollama to generate password candidates. Configure the model and context window in `config.json`:
```json
{
"ollamaModel": "mistral",
"ollamaModel": "qwen2.5:32b",
"ollamaNumCtx": 2048
}
```
- **`ollamaModel`** — The Ollama model to use for candidate generation (default: `mistral`).
- **`ollamaModel`** — The Ollama model used for candidate generation (default: `qwen2.5:32b`). The LLM attack uses structured (JSON) output, so choose a model with good tool/JSON support.
- **`ollamaNumCtx`** — Context window size for the model (default: `2048`).
- The Ollama URL defaults to `http://localhost:11434`. Ensure Ollama is running before using the LLM Attack.
- The Ollama URL defaults to `http://localhost:11434` (override via the `OLLAMA_HOST` env var). Ensure Ollama is running and the model is pulled (`ollama pull qwen2.5:32b`) before using the LLM Attack — hate_crack no longer auto-pulls missing models.
The attack offers two generation modes: **Target info** (company / industry / location) and **Wordlist** (derive denylist basewords from a sample wordlist).
### Notifications (menu option 82)