diff --git a/.env.example b/.env.example
new file mode 100644
index 0000000..a9d583a
--- /dev/null
+++ b/.env.example
@@ -0,0 +1,33 @@
+# --- IRC connection ---
+IRC_HOST=irc.example.net
+IRC_PORT=6697
+IRC_USE_TLS=true
+IRC_VERIFY_TLS=true
+IRC_NICK=HelpBot
+IRC_USER=helpbot
+IRC_REALNAME=Help Channel Assistant
+IRC_CHANNELS=#help,#support
+IRC_SASL=false
+IRC_SASL_USERNAME=HelpBot
+IRC_SASL_PASSWORD=
+IRC_NICKSERV_PASS=
+
+# --- Bot behavior ---
+BOT_COMMAND_PREFIX=!         # e.g., "!ask <question>"
+BOT_RESPOND_TO_MENTIONS=true # e.g., "HelpBot: <question>"
+BOT_COOLDOWN_SECONDS=10
+BOT_REPLY_MAX_CHARS=1500     # soft cap before splitting across IRC messages
+
+# --- OpenAI ---
+OPENAI_API_KEY=sk-xxx
+OPENAI_MODEL=gpt-5-mini
+OPENAI_REQUEST_TIMEOUT=30
+OPENAI_MAX_OUTPUT_TOKENS=600
+
+# --- Moderation ---
+MODERATION_ENABLED=true
+MODERATION_MODEL=omni-moderation-latest
+
+# --- Logging ---
+LOG_LEVEL=INFO
+LOG_JSON=true