Develop

.github/workflows/build-test.yaml

@@ -40,20 +40,14 @@ jobs:
 
     steps:
       - uses: actions/checkout@v3
-      - name: Set up Python
-        uses: actions/setup-python@v5
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
         with:
           python-version: ${{ matrix.python-version }}
+          enable-cache: true
 
-      - uses: actions/cache@v3
-        with:
-          path: ${{ env.pythonLocation }}
-          key: ${{ env.pythonLocation }}-${{ hashFiles('setup.py') }}-${{ hashFiles('requirements.txt') }}-${{ hashFiles('requirements-dev.txt') }}
-
-      - name: Upgrade pip tools
-        run: python -m pip install --upgrade pip setuptools wheel
-      - run: python -m pip install --upgrade --upgrade-strategy eager -r requirements.txt
-      - run: python -m pip install --upgrade --upgrade-strategy eager -r requirements-dev.txt
+      - name: Install dependencies
+        run: uv sync --locked --extra cpu --no-install-package llama-cpp-python
 
       - name: Prepare frontend build
         run: mkdir -p DashAI/front/build
@@ -63,4 +57,4 @@ jobs:
           name: react-build
           path: DashAI/front/build
       - name: Test with pytest
-        run: pytest -v
+        run: uv run --no-sync pytest -v

.github/workflows/db-migrations.yaml

@@ -19,15 +19,14 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v4
 
-      - name: Set up Python
-        uses: actions/setup-python@v5
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
         with:
           python-version: ${{ matrix.python-version }}
+          enable-cache: true
 
       - name: Install dependencies
-        run: |
-          pip install --upgrade --upgrade-strategy eager -r requirements.txt
-          pip install --upgrade --upgrade-strategy eager -r requirements-dev.txt
+        run: uv sync --locked --extra cpu --no-install-package llama-cpp-python
 
       - name: Set DB env vars
         run: |
@@ -37,7 +36,7 @@ jobs:
 
       - name: Show Alembic info
         run: |
-          alembic --version
+          uv run --no-sync alembic --version
           echo "DB will be at: $DATABASE_URL"
 
       - name: Prepare temp dir
@@ -48,15 +47,15 @@ jobs:
       # upgrade to head
       - name: Upgrade to head
         run: |
-          alembic -x url="$DATABASE_URL" upgrade head
+          uv run --no-sync alembic -x url="$DATABASE_URL" upgrade head
 
       # Checks downgrade and upgrade again (reversibility)
       - name: Downgrade to base and upgrade again (reversibility check)
         run: |
-          alembic -x url="$DATABASE_URL" downgrade base
-          alembic -x url="$DATABASE_URL" upgrade head
+          uv run --no-sync alembic -x url="$DATABASE_URL" downgrade base
+          uv run --no-sync alembic -x url="$DATABASE_URL" upgrade head
 
       - name: Check for pending autogenerate (python-based)
         env:
           PYTHONPATH: "${PYTHONPATH}:."
-        run: python -m scripts.ci_alembic_check
+        run: uv run --no-sync python -m scripts.ci_alembic_check

.github/workflows/docs.yaml

@@ -26,13 +26,16 @@ jobs:
         uses: actions/setup-python@v4
         with:
           python-version: "3.10"
-          cache: "pip"
-          cache-dependency-path: |
-            requirements.txt
-            requirements-dev.txt
 
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          enable-cache: true
+
+      # Installed into the system Python because the Docusaurus build
+      # invokes `python scripts/generate_components.py` directly.
       - name: Install DashAI (needed for component introspection)
-        run: pip install -e .
+        run: uv pip install --system -e .
 
       - name: Set up Node.js
         uses: actions/setup-node@v3

.github/workflows/pre-commit.yaml

@@ -23,10 +23,13 @@ jobs:
         with:
           python-version: "3.12"
 
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+
+      # Pillow goes to the system Python because the institutions-readme-sync
+      # hook is `language: system` and runs `python scripts/render_institutions.py`.
       - name: Install pre-commit
-        run: |
-          python -m pip install --upgrade pip
-          pip install pre-commit Pillow
+        run: uv pip install --system pre-commit Pillow
 
       - name: Cache pre-commit
         uses: actions/cache@v3

.github/workflows/publish.yml

@@ -59,13 +59,11 @@ jobs:
         with:
           python-version: "3.12"
 
-      - name: Install build tools
-        run: |
-          python -m pip install --upgrade pip
-          pip install build twine
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
 
       - name: Build Python package
-        run: python -m build
+        run: uv build
 
       - name: Verify frontend is included in wheel
         run: |
@@ -75,13 +73,13 @@ jobs:
           fi
 
       - name: Check distribution metadata
-        run: twine check dist/*
+        run: uvx twine check dist/*
 
       - name: Publish to PyPI
         env:
           TWINE_USERNAME: __token__
           TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
-        run: twine upload --skip-existing dist/*
+        run: uvx twine upload --skip-existing dist/*
 
   # ============================================================
   # 3. Build Windows Executable
@@ -97,19 +95,19 @@ jobs:
         with:
           name: react-build
           path: DashAI/front/build
-      - name: Set up Python 3.12
-        uses: actions/setup-python@v5
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
         with:
           python-version: "3.12"
+          enable-cache: true
       - name: Install dependencies (CPU-only)
         run: |
-          python -m pip install --upgrade pip
-          pip install -r requirements-cpu.txt
-          pip install pyinstaller
+          uv sync --locked --extra cpu --no-dev
+          uv pip install pyinstaller
       - name: Build executable
         shell: cmd
         run: |
-          pyinstaller --clean --noconfirm dashai.spec
+          uv run --no-sync pyinstaller --clean --noconfirm dashai.spec
 
       - name: Install Inno Setup
         run: choco install innosetup -y
@@ -138,19 +136,20 @@ jobs:
         with:
           name: react-build
           path: DashAI/front/build
-      - uses: actions/setup-python@v5
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
         with:
           python-version: "3.12"
+          enable-cache: true
       - name: Install dependencies (CPU-only)
         run: |
-          python -m pip install --upgrade pip
-          pip install -r requirements-cpu.txt
-          pip install pyinstaller pywebview
+          uv sync --locked --extra cpu --no-dev
+          uv pip install pyinstaller
           brew install create-dmg
 
       - name: Build ARM64 App Bundle
         run: |
-          pyinstaller --clean --noconfirm dashai.spec
+          uv run --no-sync pyinstaller --clean --noconfirm dashai.spec
 
       - name: Sign App Bundle (ad-hoc)
         run: |
@@ -190,19 +189,20 @@ jobs:
         with:
           name: react-build
           path: DashAI/front/build
-      - uses: actions/setup-python@v5
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
         with:
           python-version: "3.12"
+          enable-cache: true
       - name: Install dependencies (CPU-only)
         run: |
-          python -m pip install --upgrade pip
-          pip install -r requirements-cpu.txt
-          pip install pyinstaller pywebview
+          uv sync --locked --extra cpu --no-dev
+          uv pip install pyinstaller
           brew install create-dmg
 
       - name: Build x86_64 App Bundle
         run: |
-          pyinstaller --clean --noconfirm dashai.spec
+          uv run --no-sync pyinstaller --clean --noconfirm dashai.spec
 
       - name: Sign App Bundle (ad-hoc)
         run: |
@@ -246,14 +246,17 @@ jobs:
       - uses: actions/setup-python@v5
         with:
           python-version: "3.12"
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+      # python-appimage drives its own embedded pip, so it stays pip-based
       - name: Install build tooling
         run: |
           python -m pip install --upgrade pip
-          pip install build python-appimage
+          pip install python-appimage
           sudo apt-get update
           sudo apt-get install -y libfuse2 imagemagick librsvg2-bin
       - name: Build wheel (frontend bundled)
-        run: python -m build --wheel
+        run: uv build --wheel
       - name: Verify frontend is included in wheel
         run: |
           if ! unzip -l dist/*.whl | grep -q 'DashAI/front/build'; then
@@ -304,10 +307,10 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
-      - name: Extract version from setup.py
+      - name: Extract version from pyproject.toml
         id: version
         run: |
-          VERSION=$(grep -m 1 '    version=' setup.py | sed -E 's/.*version="([^"]+)".*/\1/')
+          VERSION=$(grep -m 1 '^version = ' pyproject.toml | sed -E 's/version = "([^"]+)"/\1/')
           echo "version=$VERSION" >> "$GITHUB_OUTPUT"
 
       - name: Download Windows installer

.gitignore

@@ -11,6 +11,8 @@ build/
 develop-eggs/
 dist/
 downloads/
+!DashAI/back/dependencies/downloads/
+!tests/back/downloads/
 eggs/
 .eggs/
 lib/
@@ -202,3 +204,8 @@ docs/node_modules/
 !docs/docs/build/**
 !docs/i18n/**/build/
 !docs/i18n/**/build/**
+
+# HuggingFace datasets cache generada al correr los tests
+tests/**/csv/default-*/
+tests/**/json/default-*/
+tests/**/tests_back_models_*.lock

CLAUDE.md

@@ -11,26 +11,31 @@ DashAI is a desktop/web graphical toolbox for training, evaluating, and deployin
 ### Backend
 
 ```bash
-# Install
-pip install -e . -r requirements-dev.txt
-pre-commit install
+# Install (uv creates .venv, installs the package editable + dev deps)
+uv sync                  # add --extra cpu on machines without NVIDIA GPU
+uv run pre-commit install
 
-# Run dev server
-python -m DashAI --no-browser --logging-level DEBUG
+# Run dev server (if you synced with --extra cpu/cuda, pass the same
+# --extra to uv run; a plain uv run re-syncs to the default torch build)
+uv run python -m DashAI --no-browser --logging-level DEBUG
 
 # Lint / format
-ruff check --fix
-ruff format
+uv run ruff check --fix
+uv run ruff format
 
 # Run all tests
-pytest tests/
+uv run pytest tests/
 
 # Run a single test file or function
-pytest tests/back/api/test_components_api.py -v
-pytest tests/back/api/test_components_api.py::test_function_name -v
+uv run pytest tests/back/api/test_components_api.py -v
+uv run pytest tests/back/api/test_components_api.py::test_function_name -v
 
 # Database migrations (auto-runs on startup, but also manually)
-alembic upgrade head
+uv run alembic upgrade head
+
+# Add / remove a dependency (updates pyproject.toml + uv.lock)
+uv add <package>
+uv remove <package>
 ```
 
 ### Frontend

DashAI/alembic/versions/9a1b2c3d4e5f_add_plot_overrides_to_explainers.py

@@ -0,0 +1,31 @@
+"""Add plot_overrides to explainers
+
+Revision ID: 9a1b2c3d4e5f
+Revises: f1a2b3c4d5e6
+Create Date: 2026-07-14 00:00:00.000000
+
+"""
+
+from typing import Sequence, Union
+
+import sqlalchemy as sa
+from alembic import op
+
+revision: str = "9a1b2c3d4e5f"
+down_revision: Union[str, None] = "f1a2b3c4d5e6"
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    op.add_column(
+        "global_explainer", sa.Column("plot_overrides", sa.JSON(), nullable=True)
+    )
+    op.add_column(
+        "local_explainer", sa.Column("plot_overrides", sa.JSON(), nullable=True)
+    )
+
+
+def downgrade() -> None:
+    op.drop_column("local_explainer", "plot_overrides")
+    op.drop_column("global_explainer", "plot_overrides")

DashAI/alembic/versions/a7d2c9e4f1b0_add_model_name_to_parameter_history.py

@@ -0,0 +1,28 @@
+"""Add model_name to parameter_history
+
+Revision ID: a7d2c9e4f1b0
+Revises: f1a2b3c4d5e6
+Create Date: 2026-07-02 00:00:00.000000
+
+"""
+
+from typing import Sequence, Union
+
+import sqlalchemy as sa
+
+from alembic import op
+
+revision: str = "a7d2c9e4f1b0"
+down_revision: Union[str, None] = "f1a2b3c4d5e6"
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    with op.batch_alter_table("parameter_history", schema=None) as batch_op:
+        batch_op.add_column(sa.Column("model_name", sa.String(), nullable=True))
+
+
+def downgrade() -> None:
+    with op.batch_alter_table("parameter_history", schema=None) as batch_op:
+        batch_op.drop_column("model_name")