diff --git a/README.md b/README.md
index 7fb8540..1f2344a 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,33 @@
 # Wireguard-Peer-Manager
+
+Adds Wireguard peers to config, reload it and send client config back via Telegram. 
+**FYI: That tool stores client private keys into server config as comments.**
+How to use:
+
+```shell
+# create initial wg config or use your own.
+# P.S. Keep in mind that WPM can't manage peers created my hands
+# due to absence of client private key.
+$ cd /etc/wireguard && mkdir clients
+$ cat > wg0.conf <<EOF
+[Interface]
+Address = 10.150.200.1/24
+ListenPort = 51820
+PrivateKey = $(wg genkey)
+PostUp = iptables -A FORWARD -i %i -o %i -j ACCEPT
+PostDown = iptables -D FORWARD -i %i -o %i -j ACCEPT
+SaveConfig = false
+EOF
+
+# install python and system requirements.
+$ pip3 install -r requirements.txt
+$ apt install qrencode
+
+# CLI usage. Client configs saved into `clients/peer_name.{conf,-qr.png,-qr.txt}`
+$ python3 gen.py --peer my-pc # add a new peer `my-pc`
+$ python3 gen.py --update     # just regenerate all configs in `clients/`
+
+# Telegram bot usage
+$ TG_TOKEN=1292121488:AAG... TG_ADMIN=<your_username> python3 bot.py
+```
+