diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
new file mode 100644
index 0000000..2fba5d7
--- /dev/null
+++ b/.github/workflows/tests.yml
@@ -0,0 +1,29 @@
+
+name: Gradient Explorer Tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt
+
+      - name: Run tests
+        run: python -m pytest -v
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..e9b1e4c
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,12 @@
+# Python cache
+__pycache__/
+*.py[cod]
+.pytest_cache/
+
+# Virtual environments
+.venv/
+.venv-*/
+venv/
+
+# Environment variables
+.env
\ No newline at end of file