fix: pin supported Python versions (3.11–3.13) and add pyproject.toml

.github/workflows/python-test.yaml

@@ -9,13 +9,16 @@ on:
 jobs:
   test-verify-email-username:
     runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ['3.11', '3.12', '3.13']
 
     steps:
-    - uses: actions/checkout@v2
-    - name: Set up Python 3.11
-      uses: actions/setup-python@v2
+    - uses: actions/checkout@v4
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v5
       with:
-        python-version: '3.11'
+        python-version: ${{ matrix.python-version }}
     - name: Install dependencies
       run: |
         python -m pip install --upgrade pip
@@ -26,17 +29,20 @@ jobs:
 
   test-data-export:
     runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ['3.11', '3.12', '3.13']
 
     steps:
-    - uses: actions/checkout@v2
-    - name: Set up Python 3.11
-      uses: actions/setup-python@v2
+    - uses: actions/checkout@v4
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v5
       with:
-        python-version: '3.11'
+        python-version: ${{ matrix.python-version }}
     - name: Install dependencies
       run: |
         python -m pip install --upgrade pip
         pip install -r requirements.txt
     - name: Run Export functions
       run: |
-        python -m unittest tests/test_export.py
+        python -m unittest tests/test_export.py

Dockerfile

@@ -1,6 +1,7 @@
-FROM python:3.12-slim
+FROM python:3.13-slim
 
+WORKDIR /app
+COPY requirements.txt .
+RUN python3 -m pip install --no-cache-dir -r requirements.txt
 COPY . .
-
-RUN python3 -m pip install -r requirements.txt
-ENTRYPOINT ["python3","blackbird.py"]
+ENTRYPOINT ["python3", "blackbird.py"]

README.md

@@ -18,10 +18,18 @@ cd blackbird
 
 **Install requirements**
 
+> Blackbird requires **Python 3.11 – 3.13**.
+
 ```bash
 pip install -r requirements.txt
 ```
 
+**Run with Python 3.11 – 3.13**
+
+```bash
+python blackbird.py --username johndoe
+```
+
 ### Usage
 
 **Search by username**

pyproject.toml

@@ -0,0 +1,39 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "blackbird"
+description = "An OSINT tool to search for accounts by username and email in social networks."
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.11,<3.14"
+dynamic = ["version"]
+
+dependencies = [
+    "aiohappyeyeballs==2.6.1",
+    "aiohttp==3.12.13",
+    "aiosignal==1.3.2",
+    "attrs==25.3.0",
+    "certifi==2025.6.15",
+    "chardet==5.2.0",
+    "charset-normalizer==3.4.2",
+    "frozenlist==1.7.0",
+    "idna==3.10",
+    "markdown-it-py==3.0.0",
+    "mdurl==0.1.2",
+    "multidict==6.6.2",
+    "pillow==11.3.0",
+    "propcache==0.3.2",
+    "Pygments==2.19.2",
+    "python-dotenv==1.1.1",
+    "reportlab==4.4.2",
+    "requests==2.32.4",
+    "rich==14.0.0",
+    "urllib3==2.5.0",
+    "yarl==1.20.1",
+]
+
+[project.urls]
+Homepage = "https://github.com/p1ngul1n0/blackbird"
+Documentation = "https://p1ngul1n0.gitbook.io/blackbird/"