diff --git a/.env.example b/.env.example
new file mode 100644
index 0000000..4ef01a5
--- /dev/null
+++ b/.env.example
@@ -0,0 +1,11 @@
+# GitHub Notification Copilot — Environment Variables
+
+# Required
+GITHUB_TOKEN=ghp_your_github_token_here
+
+# Optional — enables LLM-powered classification (falls back to rule-based without this)
+ANTHROPIC_API_KEY=sk-ant-your-key-here
+
+# Optional tuning
+TRIAGE_LIMIT=50          # max notifications per run
+TRIAGE_DRY_RUN=false     # set to true to preview without executing actions
diff --git a/setup.py b/setup.py
new file mode 100644
index 0000000..fed31c1
--- /dev/null
+++ b/setup.py
@@ -0,0 +1,23 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="github-notifications-copilot",
+    version="1.0.0",
+    description="AI-powered GitHub notification triage using Claude",
+    py_modules=["notification_copilot", "github_api_client", "llm_classifier", "actions_executor"],
+    python_requires=">=3.11",
+    install_requires=[
+        "requests>=2.31.0",
+        "pyyaml>=6.0.1",
+        "python-dotenv>=1.0.0",
+    ],
+    extras_require={
+        "llm": ["anthropic>=0.25.0"],
+        "dev": ["pytest>=7.4.0", "pytest-cov>=4.1.0"],
+    },
+    entry_points={
+        "console_scripts": [
+            "gh-copilot=notification_copilot:main",
+        ]
+    },
+)