From 11919e516b2cb1a4514e6b9be7937d994c671c93 Mon Sep 17 00:00:00 2001
From: agatha <agatha@juggalol.com>
Date: Sat, 14 Mar 2026 12:11:49 -0400
Subject: [PATCH] chore: initial commit

---
 .gitignore              | 18 ++++++++++++++++++
 .pre-commit-config.yaml | 13 +++++++++++++
 .python-version         |  1 +
 README.md               |  4 ++++
 pyproject.toml          | 10 ++++++++++
 uv.lock                 |  8 ++++++++
 6 files changed, 54 insertions(+)
 create mode 100644 .gitignore
 create mode 100644 .pre-commit-config.yaml
 create mode 100644 .python-version
 create mode 100644 README.md
 create mode 100644 pyproject.toml
 create mode 100644 uv.lock

diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..3179c29
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,18 @@
+# IDE files
+.vscode/
+.idea/
+
+# Environment files
+.env*
+!.env.example
+
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
new file mode 100644
index 0000000..d5c2319
--- /dev/null
+++ b/.pre-commit-config.yaml
@@ -0,0 +1,13 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.9.10
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+
+  - repo: https://github.com/compilerla/conventional-pre-commit
+    rev: v4.1.0
+    hooks:
+      - id: conventional-pre-commit
+        stages: [commit-msg]
\ No newline at end of file
diff --git a/.python-version b/.python-version
new file mode 100644
index 0000000..e4fba21
--- /dev/null
+++ b/.python-version
@@ -0,0 +1 @@
+3.12
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..7288a96
--- /dev/null
+++ b/README.md
@@ -0,0 +1,4 @@
+# Proxy Pool
+Proxy Pool is a FastAPI backend that discovers, validates, and serves free proxy servers. It scrapes configurable proxy
+list sources, runs a multi-stage validation pipeline to determine which proxies are alive and usable, and exposes a
+query API for consumers to find and acquire working proxies.
diff --git a/pyproject.toml b/pyproject.toml
new file mode 100644
index 0000000..686f3df
--- /dev/null
+++ b/pyproject.toml
@@ -0,0 +1,10 @@
+[project]
+name = "proxy-pool"
+version = "0.1.0"
+description = "Proxy harvesting framework"
+readme = "README.md"
+authors = [
+    { name = "agatha", email = "agatha@juggalol.com" }
+]
+requires-python = ">=3.12"
+dependencies = []
diff --git a/uv.lock b/uv.lock
new file mode 100644
index 0000000..a923e9b
--- /dev/null
+++ b/uv.lock
@@ -0,0 +1,8 @@
+version = 1
+revision = 3
+requires-python = ">=3.12"
+
+[[package]]
+name = "proxy-pool"
+version = "0.1.0"
+source = { virtual = "." }