From 1d67cbe2c7b734eef7fe77e50878aef9316c4141 Mon Sep 17 00:00:00 2001
From: Soxoj <31013580+soxoj@users.noreply.github.com>
Date: Thu, 21 May 2026 19:27:45 +0200
Subject: [PATCH] Enhance README with AI profiling and analysis details (#2691)
---
README.md | 4 +++-
1 file changed, 3 insertions(+), 1 deletion(-)
diff --git a/README.md b/README.md
index 9f5746c9..3e43b596 100644
--- a/README.md
+++ b/README.md
@@ -30,7 +30,7 @@
-**Maigret** collects a dossier on a person **by username only**, checking for accounts on a huge number of sites and gathering all the available information from web pages. No API keys required.
+**Maigret** collects a dossier on a person **by username only**, checking for accounts on a huge number of sites and gathering all the available information from web pages. No API keys required. **[AI profiling (demo)](#ai-analysis)**.
## Contents
@@ -254,6 +254,8 @@ See the full [library usage guide](https://maigret.readthedocs.io/en/latest/libr
### AI analysis
+[](https://asciinema.org/a/979404)
+
`--ai` collects the search results, builds an internal Markdown report, and sends it to an OpenAI-compatible chat completion endpoint to produce a short, neutral investigation summary (likely real name, location, occupation, interests, languages, confidence, follow-up leads). Per-site progress is suppressed and the model's output is streamed to stdout.
```bash