diff --git a/pyproject.toml b/pyproject.toml
new file mode 100644
index 0000000..d761be6
--- /dev/null
+++ b/pyproject.toml
@@ -0,0 +1,17 @@
+[tool.ruff]
+target-version = "py311"
+line-length = 120
+extend-exclude = ["migrations"]
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "B", "S"]
+ignore = [
+    "E501",  # длинные строки в промптах и шаблонах сообщений
+    "B904",  # raise из except в обработчиках API — осознанно без цепочки
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/*" = ["S101", "S105", "S106"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
diff --git a/requirements-dev.txt b/requirements-dev.txt
new file mode 100644
index 0000000..b065da0
--- /dev/null
+++ b/requirements-dev.txt
@@ -0,0 +1,3 @@
+-r requirements.txt
+pytest==8.4.2
+ruff==0.14.0
diff --git a/requirements.txt b/requirements.txt
index 9dc05bf..7ee3a73 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -8,4 +8,5 @@ openai==1.58.1
 python-dotenv==1.0.1
 Werkzeug==3.1.3
 Pillow==11.0.0
-playwright>=1.40
+playwright==1.60.0
+gunicorn==25.3.0