Hanani — Geopolitical News Reasoning

Hanani is a standalone geopolitical reasoning system — expandable semantic graphs + a layered assessment engine, not a one-off crisis briefing or news reader.

What do all available reports imply when combined?

Requirements (web): run hanani docs serve → http://127.0.0.1:8805/

Architecture: docs/reasoning-system.md · docs/requirements.md · docs/review-2026-08-08.md (functional + code review of 0.8.0; findings actioned in 0.9.0 — expanded offline floor, unassessed audit scores, declared-vs-detectable coverage on status commands)

Initial focus: Russia–Ukraine, Hormuz Strait / US–Iran–Gulf states.

See docs/vision.md.

hanani --help
hanani factors
hanani reasoning         # engine status (Layer 1 → Layer 2 pipeline)
hanani ontology          # mechanism graph (L1–L5)
hanani rhetoric          # fallacy / audit graph
hanani workflow status
hanani docs serve          # requirements + architecture as web pages

# The vertical slice — article → atoms → Layer 1 rhetoric → Layer 2 → persisted:
hanani ingest article.txt --source-id reuters --title "Odesa depot strike"
hanani ingest article.txt --source-id reuters --hoglah-model llama3   # + model tier
hanani corpus              # summarise the persisted store (~/.hanani)
hanani gaps                # registry-aware gaps and stated information needs
hanani relations           # typed, auditable relations between assessed atoms
hanani push-tirzah         # push stored records into Tirzah memory (tirzah extra)
hanani debate              # Milcah multi-LLM debate over admissible atoms (milcah extra)

Graphs: living-semantic-model.md · rhetorical-logic-graph.md

Family stack

Install

pipx install hanani
hanani --help

Optional extras: pipx inject hanani 'hanani[milcah]', hanani[tirzah], hanani[family]. hanani docs serve needs a git checkout (docs are not in the wheel).

Develop

pip install -e ".[dev]"
pytest

License

Apache License 2.0.