working at least

README.md

@@ -0,0 +1,32 @@
+# Tag Hunter
+
+Simple Python TUI/CLI utility for finding Telegram nicknames that:
+
+1. Do not appear to belong to a user, channel, or group on Telegram.
+2. Do not show up as an auction/sale listing on Fragment.
+
+This MVP uses public web pages, not private Telegram credentials or Fragment tokens.
+It also retries on `429` and transient `5xx` responses with exponential backoff.
+
+## Run
+
+```bash
+python tag_hunter.py nicknames.txt
+```
+
+Or run without arguments and enter the file path interactively.
+
+## Input format
+
+One nickname per line. Leading `@` is optional.
+
+```text
+alice
+@bob
+charlie_123
+```
+
+## Notes
+
+- The checker is best-effort. Public pages can change, and some usernames may be reported as `UNKNOWN` if the response is ambiguous or the site rate-limits too aggressively.
+- The estimated runtime shown at startup is approximate and depends on network latency and retries.