Initial commit with cleaned history and environment configuration

README.md

@@ -0,0 +1,37 @@
+# AdGuard Monitor
+
+Monitoring service for AdGuard DNS queries with notifications sent to Home Assistant.
+
+## Who is this for?
+> This is for me mainly, so let's see if you need it too.
+Adguard Monitor is designed for openclaw, which should usually NEVER make a request that needs to be blocked. If it does, I want to know about it immediately.
+
+## Features
+-   **Multi-Client Support**: Monitor specific IP addresses and receive nicknamed notifications (e.g., "BLOCKED: My Laptop").
+-   **Strict Configuration**: Fails fast if environment variables are missing.
+-   **Home Assistant Notifications**: Native mobile push messages for blocked queries.
+-   **Structured Logging**: UTF-8 encoded logging for unicode emoji support.
+
+## Setup
+
+1.  **Clone the repository.**
+2.  **Install dependencies**:
+    ```bash
+    pip install -r requirements.txt
+    ```
+3.  **Configure environment**:
+    Copy `.env.example` to `.env` and fill in your details:
+    ```bash
+    cp .env.example .env
+    ```
+4.  **Run the monitor**:
+    ```bash
+    python monitor.py --interval 15
+    ```
+
+## Environment Variables
+-   `ADGUARD_URL`: Full URL of your AdGuard instance (e.g., `http://192.168.1.50`).
+-   `ADGUARD_USER/PASSWORD`: API credentials.
+-   `CLIENTS`: A JSON-formatted dictionary mapping IPs to display names.
+-   `HASS_URL/TOKEN`: Home Assistant mobile notification endpoint and Long-Lived Access Token.
+