QuickLab-MCP 0.1.0__tar.gz → 0.2.1__tar.gz

{quicklab_mcp-0.1.0 → quicklab_mcp-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: QuickLab-MCP
-Version: 0.1.0
+Version: 0.2.1
 Summary: QuickLab MCP Server - Production Tabular ML Experimentation Control Plane for AI Agents
 Author: QuickLab Team
 License-Expression: Apache-2.0
@@ -19,6 +19,7 @@ Requires-Dist: fastmcp==4.0.5
 Requires-Dist: pydantic<3.0.0,>=2.7.0
 Requires-Dist: pydantic-settings<3.0.0,>=2.2.0
 Requires-Dist: sqlalchemy[asyncio]<3.0.0,>=2.0.30
+Requires-Dist: aiosqlite>=0.20.0
 Requires-Dist: asyncpg>=0.29.0
 Requires-Dist: redis>=5.0.4
 Requires-Dist: boto3>=1.34.0
@@ -44,7 +45,6 @@ Provides-Extra: dev
 Requires-Dist: pytest>=8.2.0; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
 Requires-Dist: pytest-cov>=5.0.0; extra == "dev"
-Requires-Dist: aiosqlite>=0.20.0; extra == "dev"
 Requires-Dist: ruff>=0.4.0; extra == "dev"
 Requires-Dist: mypy>=1.10.0; extra == "dev"
 Requires-Dist: types-redis>=4.6.0; extra == "dev"
@@ -57,7 +57,7 @@ Requires-Dist: types-PyYAML>=6.0.0; extra == "dev"
 [![PyPI](https://img.shields.io/badge/pypi-QuickLab--MCP-blue.svg)](https://pypi.org/project/QuickLab-MCP/)
 [![MCP Protocol](https://img.shields.io/badge/MCP%20Protocol-2026--07--28-orange.svg)](https://modelcontextprotocol.io/)
 [![FastMCP](https://img.shields.io/badge/FastMCP-4.0.5%20GA-green.svg)](https://github.com/jlowin/fastmcp)
-[![Tests](https://img.shields.io/badge/tests-104%20passed%20%7C%20100%25-brightgreen.svg)]()
+[![Tests](https://img.shields.io/badge/tests-108%20passed%20%7C%20100%25-brightgreen.svg)]()
 [![Code Style](https://img.shields.io/badge/code%20style-ruff-black.svg)](https://github.com/astral-sh/ruff)
 [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
 [![Security](https://img.shields.io/badge/security-OAuth%202.1%20%2F%20OIDC-purple.svg)]()
@@ -77,7 +77,7 @@ Requires-Dist: types-PyYAML>=6.0.0; extra == "dev"
 - **OAuth 2.1 & Multi-Tenant Security**: Tenant boundary enforcement, RBAC matrix (`Viewer`, `Researcher`, `Operator`, `Admin`), token scope attenuation, and anti-enumeration protections (HTTP 404 instead of 403 on cross-tenant probes).
 - **Transactional Outbox Architecture**: Guarantees zero lost experiment submissions using PostgreSQL transactional Outbox events dispatched to Redis queues.
 - **S3 / MinIO Object Storage**: Immutable tenant-isolated artifact storage with SHA-256 integrity verification, presigned download URLs, and offline memory fallback.
-- **Full Test Coverage**: **104 tests passing (100% green)** across unit, integration, security matrix, MCP contract, and full end-to-end experiment lifecycle.
+- **Full Test Coverage**: **108 tests passing (100% green)** across unit, integration, security matrix, MCP contract, zero-config fallbacks, and full end-to-end experiment lifecycle.
 
 ---
 
@@ -304,28 +304,27 @@ ModelLab supports both **STDIO** (local subprocess IPC) and **Streamable HTTP**
 
 Select your preferred runtime configuration below:
 
-### 1. Docker + STDIO
-Runs ModelLab inside an isolated Docker container with standard I/O (`sys.stdin` / `sys.stdout`) piped directly to the MCP client.
+### 1. Docker + STDIO (Pre-Built Image)
+Runs QuickLab inside an isolated Docker container with standard I/O (`sys.stdin` / `sys.stdout`) piped directly to the MCP client:
 
 ```json
 {
   "mcpServers": {
-    "modellab": {
+    "quicklab": {
       "command": "docker",
       "args": [
         "run",
         "-i",
         "--rm",
         "--entrypoint", "python",
-        "--network", "host",
         "-e", "APP_ENV=production",
-        "-e", "DATABASE_URL=postgresql+asyncpg://postgres:postgres@localhost:5433/modellab",
-        "-e", "REDIS_URL=redis://localhost:6379/0",
-        "-e", "OBJECT_STORE_ENDPOINT_URL=http://localhost:9000",
+        "-e", "DATABASE_URL=postgresql+asyncpg://postgres:postgres@host.docker.internal:5433/modellab",
+        "-e", "REDIS_URL=redis://host.docker.internal:6379/0",
+        "-e", "OBJECT_STORE_ENDPOINT_URL=http://host.docker.internal:9000",
         "-e", "OBJECT_STORE_ACCESS_KEY_ID=minioadmin",
         "-e", "OBJECT_STORE_SECRET_ACCESS_KEY=minioadmin",
         "-e", "OBJECT_STORE_BUCKET_NAME=modellab-artifacts",
-        "modellab-api",
+        "ghcr.io/aldrin-joan/quicklab-api:latest",
         "-m", "ml_mcp.server.stdio"
       ]
     }
@@ -333,11 +332,10 @@ Runs ModelLab inside an isolated Docker container with standard I/O (`sys.stdin`
 }
 ```
 
-> **Note for Docker Desktop (macOS / Windows)**: If `--network host` is unavailable in your Docker Desktop environment, connect via the shared Docker network:
+> **Note for Docker Networking**: If running local services on your host, `host.docker.internal` allows the container to connect to your host ports seamlessly on macOS, Windows, and Linux. If using Docker Compose, connect via the shared Docker network:
 > ```json
 > "args": [
 >   "run", "-i", "--rm",
->   "--entrypoint", "python",
 >   "--network", "modellab_default",
 >   "-e", "DATABASE_URL=postgresql+asyncpg://postgres:postgres@postgres:5432/modellab",
 >   "-e", "REDIS_URL=redis://redis:6379/0",
@@ -345,11 +343,42 @@ Runs ModelLab inside an isolated Docker container with standard I/O (`sys.stdin`
 >   "-e", "OBJECT_STORE_ACCESS_KEY_ID=minioadmin",
 >   "-e", "OBJECT_STORE_SECRET_ACCESS_KEY=minioadmin",
 >   "-e", "OBJECT_STORE_BUCKET_NAME=modellab-artifacts",
->   "modellab-api",
+>   "ghcr.io/aldrin-joan/quicklab-api:latest",
 >   "-m", "ml_mcp.server.stdio"
 > ]
 > ```
 
+---
+
+### Database Schema Initialization & Migrations
+
+When pointing QuickLab to a new PostgreSQL instance (local, AWS RDS, Supabase, Neon, or GCP Cloud SQL), the schema must be initialized with Alembic migrations:
+
+#### Option A: Docker Compose (Fully Automated)
+If deploying via [`docker-compose.stdio.yml`](docker-compose.stdio.yml) or [`docker-compose.http.yml`](docker-compose.http.yml), migrations execute automatically prior to application launch via the `db-migrate` service:
+```bash
+docker compose -f docker-compose.stdio.yml up -d
+```
+
+#### Option B: Standalone Docker (External / Managed Database)
+Run migrations on a remote or standalone PostgreSQL instance without installing Python or cloning the repo:
+```bash
+docker run --rm \
+  -e DATABASE_URL="postgresql+asyncpg://<USER>:<PASSWORD>@<HOST>:<PORT>/<DB_NAME>" \
+  ghcr.io/aldrin-joan/quicklab-api:latest \
+  -m alembic upgrade head
+```
+
+#### Option C: Local Python / UV (Source Repository)
+If running from source:
+```bash
+uv run alembic upgrade head
+```
+
+> [!NOTE]
+> **Automatic Seed Data**: Once Alembic creates the schema, QuickLab's startup lifespan automatically seeds the 7 approved tabular ML models and ensures a default project workspace exists for the tenant.
+
+
 ---
 
 ### 2. Docker + HTTP
@@ -371,7 +400,24 @@ Connects to the ModelLab API service running inside Docker Compose (`docker comp
 ---
 
 ### 3. UVX + STDIO (Recommended Turnkey Setup)
-Runs QuickLab globally via `uvx` directly from PyPI:
+Runs QuickLab globally via `uvx` directly from PyPI.
+
+#### Zero-Configuration Mode (Zero Dependencies Required)
+If you don't have PostgreSQL or Docker installed, QuickLab automatically provisions an embedded SQLite database (`~/.quicklab/quicklab.db`), local filesystem artifact storage (`~/.quicklab/artifacts`), and an in-process queue:
+
+```json
+{
+  "mcpServers": {
+    "quicklab": {
+      "command": "uvx",
+      "args": ["quicklab-mcp"]
+    }
+  }
+}
+```
+
+#### Production Mode (Connecting to PostgreSQL & MinIO / S3)
+To connect QuickLab to your own PostgreSQL and S3-compatible storage:
 
 ```json
 {

{quicklab_mcp-0.1.0 → quicklab_mcp-0.2.1}/README.md

@@ -4,7 +4,7 @@
 [![PyPI](https://img.shields.io/badge/pypi-QuickLab--MCP-blue.svg)](https://pypi.org/project/QuickLab-MCP/)
 [![MCP Protocol](https://img.shields.io/badge/MCP%20Protocol-2026--07--28-orange.svg)](https://modelcontextprotocol.io/)
 [![FastMCP](https://img.shields.io/badge/FastMCP-4.0.5%20GA-green.svg)](https://github.com/jlowin/fastmcp)
-[![Tests](https://img.shields.io/badge/tests-104%20passed%20%7C%20100%25-brightgreen.svg)]()
+[![Tests](https://img.shields.io/badge/tests-108%20passed%20%7C%20100%25-brightgreen.svg)]()
 [![Code Style](https://img.shields.io/badge/code%20style-ruff-black.svg)](https://github.com/astral-sh/ruff)
 [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
 [![Security](https://img.shields.io/badge/security-OAuth%202.1%20%2F%20OIDC-purple.svg)]()
@@ -24,7 +24,7 @@
 - **OAuth 2.1 & Multi-Tenant Security**: Tenant boundary enforcement, RBAC matrix (`Viewer`, `Researcher`, `Operator`, `Admin`), token scope attenuation, and anti-enumeration protections (HTTP 404 instead of 403 on cross-tenant probes).
 - **Transactional Outbox Architecture**: Guarantees zero lost experiment submissions using PostgreSQL transactional Outbox events dispatched to Redis queues.
 - **S3 / MinIO Object Storage**: Immutable tenant-isolated artifact storage with SHA-256 integrity verification, presigned download URLs, and offline memory fallback.
-- **Full Test Coverage**: **104 tests passing (100% green)** across unit, integration, security matrix, MCP contract, and full end-to-end experiment lifecycle.
+- **Full Test Coverage**: **108 tests passing (100% green)** across unit, integration, security matrix, MCP contract, zero-config fallbacks, and full end-to-end experiment lifecycle.
 
 ---
 
@@ -251,28 +251,27 @@ ModelLab supports both **STDIO** (local subprocess IPC) and **Streamable HTTP**
 
 Select your preferred runtime configuration below:
 
-### 1. Docker + STDIO
-Runs ModelLab inside an isolated Docker container with standard I/O (`sys.stdin` / `sys.stdout`) piped directly to the MCP client.
+### 1. Docker + STDIO (Pre-Built Image)
+Runs QuickLab inside an isolated Docker container with standard I/O (`sys.stdin` / `sys.stdout`) piped directly to the MCP client:
 
 ```json
 {
   "mcpServers": {
-    "modellab": {
+    "quicklab": {
       "command": "docker",
       "args": [
         "run",
         "-i",
         "--rm",
         "--entrypoint", "python",
-        "--network", "host",
         "-e", "APP_ENV=production",
-        "-e", "DATABASE_URL=postgresql+asyncpg://postgres:postgres@localhost:5433/modellab",
-        "-e", "REDIS_URL=redis://localhost:6379/0",
-        "-e", "OBJECT_STORE_ENDPOINT_URL=http://localhost:9000",
+        "-e", "DATABASE_URL=postgresql+asyncpg://postgres:postgres@host.docker.internal:5433/modellab",
+        "-e", "REDIS_URL=redis://host.docker.internal:6379/0",
+        "-e", "OBJECT_STORE_ENDPOINT_URL=http://host.docker.internal:9000",
         "-e", "OBJECT_STORE_ACCESS_KEY_ID=minioadmin",
         "-e", "OBJECT_STORE_SECRET_ACCESS_KEY=minioadmin",
         "-e", "OBJECT_STORE_BUCKET_NAME=modellab-artifacts",
-        "modellab-api",
+        "ghcr.io/aldrin-joan/quicklab-api:latest",
         "-m", "ml_mcp.server.stdio"
       ]
     }
@@ -280,11 +279,10 @@ Runs ModelLab inside an isolated Docker container with standard I/O (`sys.stdin`
 }
 ```
 
-> **Note for Docker Desktop (macOS / Windows)**: If `--network host` is unavailable in your Docker Desktop environment, connect via the shared Docker network:
+> **Note for Docker Networking**: If running local services on your host, `host.docker.internal` allows the container to connect to your host ports seamlessly on macOS, Windows, and Linux. If using Docker Compose, connect via the shared Docker network:
 > ```json
 > "args": [
 >   "run", "-i", "--rm",
->   "--entrypoint", "python",
 >   "--network", "modellab_default",
 >   "-e", "DATABASE_URL=postgresql+asyncpg://postgres:postgres@postgres:5432/modellab",
 >   "-e", "REDIS_URL=redis://redis:6379/0",
@@ -292,11 +290,42 @@ Runs ModelLab inside an isolated Docker container with standard I/O (`sys.stdin`
 >   "-e", "OBJECT_STORE_ACCESS_KEY_ID=minioadmin",
 >   "-e", "OBJECT_STORE_SECRET_ACCESS_KEY=minioadmin",
 >   "-e", "OBJECT_STORE_BUCKET_NAME=modellab-artifacts",
->   "modellab-api",
+>   "ghcr.io/aldrin-joan/quicklab-api:latest",
 >   "-m", "ml_mcp.server.stdio"
 > ]
 > ```
 
+---
+
+### Database Schema Initialization & Migrations
+
+When pointing QuickLab to a new PostgreSQL instance (local, AWS RDS, Supabase, Neon, or GCP Cloud SQL), the schema must be initialized with Alembic migrations:
+
+#### Option A: Docker Compose (Fully Automated)
+If deploying via [`docker-compose.stdio.yml`](docker-compose.stdio.yml) or [`docker-compose.http.yml`](docker-compose.http.yml), migrations execute automatically prior to application launch via the `db-migrate` service:
+```bash
+docker compose -f docker-compose.stdio.yml up -d
+```
+
+#### Option B: Standalone Docker (External / Managed Database)
+Run migrations on a remote or standalone PostgreSQL instance without installing Python or cloning the repo:
+```bash
+docker run --rm \
+  -e DATABASE_URL="postgresql+asyncpg://<USER>:<PASSWORD>@<HOST>:<PORT>/<DB_NAME>" \
+  ghcr.io/aldrin-joan/quicklab-api:latest \
+  -m alembic upgrade head
+```
+
+#### Option C: Local Python / UV (Source Repository)
+If running from source:
+```bash
+uv run alembic upgrade head
+```
+
+> [!NOTE]
+> **Automatic Seed Data**: Once Alembic creates the schema, QuickLab's startup lifespan automatically seeds the 7 approved tabular ML models and ensures a default project workspace exists for the tenant.
+
+
 ---
 
 ### 2. Docker + HTTP
@@ -318,7 +347,24 @@ Connects to the ModelLab API service running inside Docker Compose (`docker comp
 ---
 
 ### 3. UVX + STDIO (Recommended Turnkey Setup)
-Runs QuickLab globally via `uvx` directly from PyPI:
+Runs QuickLab globally via `uvx` directly from PyPI.
+
+#### Zero-Configuration Mode (Zero Dependencies Required)
+If you don't have PostgreSQL or Docker installed, QuickLab automatically provisions an embedded SQLite database (`~/.quicklab/quicklab.db`), local filesystem artifact storage (`~/.quicklab/artifacts`), and an in-process queue:
+
+```json
+{
+  "mcpServers": {
+    "quicklab": {
+      "command": "uvx",
+      "args": ["quicklab-mcp"]
+    }
+  }
+}
+```
+
+#### Production Mode (Connecting to PostgreSQL & MinIO / S3)
+To connect QuickLab to your own PostgreSQL and S3-compatible storage:
 
 ```json
 {

{quicklab_mcp-0.1.0 → quicklab_mcp-0.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "QuickLab-MCP"
-version = "0.1.0"
+version = "0.2.1"
 description = "QuickLab MCP Server - Production Tabular ML Experimentation Control Plane for AI Agents"
 readme = "README.md"
 requires-python = ">=3.13"
@@ -25,6 +25,7 @@ dependencies = [
     "pydantic>=2.7.0,<3.0.0",
     "pydantic-settings>=2.2.0,<3.0.0",
     "sqlalchemy[asyncio]>=2.0.30,<3.0.0",
+    "aiosqlite>=0.20.0",
     "asyncpg>=0.29.0",
     "redis>=5.0.4",
     "boto3>=1.34.0",
@@ -64,7 +65,6 @@ dev = [
     "pytest>=8.2.0",
     "pytest-asyncio>=0.23.0",
     "pytest-cov>=5.0.0",
-    "aiosqlite>=0.20.0",
     "ruff>=0.4.0",
     "mypy>=1.10.0",
     "types-redis>=4.6.0",

{quicklab_mcp-0.1.0 → quicklab_mcp-0.2.1}/src/QuickLab_MCP.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: QuickLab-MCP
-Version: 0.1.0
+Version: 0.2.1
 Summary: QuickLab MCP Server - Production Tabular ML Experimentation Control Plane for AI Agents
 Author: QuickLab Team
 License-Expression: Apache-2.0
@@ -19,6 +19,7 @@ Requires-Dist: fastmcp==4.0.5
 Requires-Dist: pydantic<3.0.0,>=2.7.0
 Requires-Dist: pydantic-settings<3.0.0,>=2.2.0
 Requires-Dist: sqlalchemy[asyncio]<3.0.0,>=2.0.30
+Requires-Dist: aiosqlite>=0.20.0
 Requires-Dist: asyncpg>=0.29.0
 Requires-Dist: redis>=5.0.4
 Requires-Dist: boto3>=1.34.0
@@ -44,7 +45,6 @@ Provides-Extra: dev
 Requires-Dist: pytest>=8.2.0; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
 Requires-Dist: pytest-cov>=5.0.0; extra == "dev"
-Requires-Dist: aiosqlite>=0.20.0; extra == "dev"
 Requires-Dist: ruff>=0.4.0; extra == "dev"
 Requires-Dist: mypy>=1.10.0; extra == "dev"
 Requires-Dist: types-redis>=4.6.0; extra == "dev"
@@ -57,7 +57,7 @@ Requires-Dist: types-PyYAML>=6.0.0; extra == "dev"
 [![PyPI](https://img.shields.io/badge/pypi-QuickLab--MCP-blue.svg)](https://pypi.org/project/QuickLab-MCP/)
 [![MCP Protocol](https://img.shields.io/badge/MCP%20Protocol-2026--07--28-orange.svg)](https://modelcontextprotocol.io/)
 [![FastMCP](https://img.shields.io/badge/FastMCP-4.0.5%20GA-green.svg)](https://github.com/jlowin/fastmcp)
-[![Tests](https://img.shields.io/badge/tests-104%20passed%20%7C%20100%25-brightgreen.svg)]()
+[![Tests](https://img.shields.io/badge/tests-108%20passed%20%7C%20100%25-brightgreen.svg)]()
 [![Code Style](https://img.shields.io/badge/code%20style-ruff-black.svg)](https://github.com/astral-sh/ruff)
 [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
 [![Security](https://img.shields.io/badge/security-OAuth%202.1%20%2F%20OIDC-purple.svg)]()
@@ -77,7 +77,7 @@ Requires-Dist: types-PyYAML>=6.0.0; extra == "dev"
 - **OAuth 2.1 & Multi-Tenant Security**: Tenant boundary enforcement, RBAC matrix (`Viewer`, `Researcher`, `Operator`, `Admin`), token scope attenuation, and anti-enumeration protections (HTTP 404 instead of 403 on cross-tenant probes).
 - **Transactional Outbox Architecture**: Guarantees zero lost experiment submissions using PostgreSQL transactional Outbox events dispatched to Redis queues.
 - **S3 / MinIO Object Storage**: Immutable tenant-isolated artifact storage with SHA-256 integrity verification, presigned download URLs, and offline memory fallback.
-- **Full Test Coverage**: **104 tests passing (100% green)** across unit, integration, security matrix, MCP contract, and full end-to-end experiment lifecycle.
+- **Full Test Coverage**: **108 tests passing (100% green)** across unit, integration, security matrix, MCP contract, zero-config fallbacks, and full end-to-end experiment lifecycle.
 
 ---
 
@@ -304,28 +304,27 @@ ModelLab supports both **STDIO** (local subprocess IPC) and **Streamable HTTP**
 
 Select your preferred runtime configuration below:
 
-### 1. Docker + STDIO
-Runs ModelLab inside an isolated Docker container with standard I/O (`sys.stdin` / `sys.stdout`) piped directly to the MCP client.
+### 1. Docker + STDIO (Pre-Built Image)
+Runs QuickLab inside an isolated Docker container with standard I/O (`sys.stdin` / `sys.stdout`) piped directly to the MCP client:
 
 ```json
 {
   "mcpServers": {
-    "modellab": {
+    "quicklab": {
       "command": "docker",
       "args": [
         "run",
         "-i",
         "--rm",
         "--entrypoint", "python",
-        "--network", "host",
         "-e", "APP_ENV=production",
-        "-e", "DATABASE_URL=postgresql+asyncpg://postgres:postgres@localhost:5433/modellab",
-        "-e", "REDIS_URL=redis://localhost:6379/0",
-        "-e", "OBJECT_STORE_ENDPOINT_URL=http://localhost:9000",
+        "-e", "DATABASE_URL=postgresql+asyncpg://postgres:postgres@host.docker.internal:5433/modellab",
+        "-e", "REDIS_URL=redis://host.docker.internal:6379/0",
+        "-e", "OBJECT_STORE_ENDPOINT_URL=http://host.docker.internal:9000",
         "-e", "OBJECT_STORE_ACCESS_KEY_ID=minioadmin",
         "-e", "OBJECT_STORE_SECRET_ACCESS_KEY=minioadmin",
         "-e", "OBJECT_STORE_BUCKET_NAME=modellab-artifacts",
-        "modellab-api",
+        "ghcr.io/aldrin-joan/quicklab-api:latest",
         "-m", "ml_mcp.server.stdio"
       ]
     }
@@ -333,11 +332,10 @@ Runs ModelLab inside an isolated Docker container with standard I/O (`sys.stdin`
 }
 ```
 
-> **Note for Docker Desktop (macOS / Windows)**: If `--network host` is unavailable in your Docker Desktop environment, connect via the shared Docker network:
+> **Note for Docker Networking**: If running local services on your host, `host.docker.internal` allows the container to connect to your host ports seamlessly on macOS, Windows, and Linux. If using Docker Compose, connect via the shared Docker network:
 > ```json
 > "args": [
 >   "run", "-i", "--rm",
->   "--entrypoint", "python",
 >   "--network", "modellab_default",
 >   "-e", "DATABASE_URL=postgresql+asyncpg://postgres:postgres@postgres:5432/modellab",
 >   "-e", "REDIS_URL=redis://redis:6379/0",
@@ -345,11 +343,42 @@ Runs ModelLab inside an isolated Docker container with standard I/O (`sys.stdin`
 >   "-e", "OBJECT_STORE_ACCESS_KEY_ID=minioadmin",
 >   "-e", "OBJECT_STORE_SECRET_ACCESS_KEY=minioadmin",
 >   "-e", "OBJECT_STORE_BUCKET_NAME=modellab-artifacts",
->   "modellab-api",
+>   "ghcr.io/aldrin-joan/quicklab-api:latest",
 >   "-m", "ml_mcp.server.stdio"
 > ]
 > ```
 
+---
+
+### Database Schema Initialization & Migrations
+
+When pointing QuickLab to a new PostgreSQL instance (local, AWS RDS, Supabase, Neon, or GCP Cloud SQL), the schema must be initialized with Alembic migrations:
+
+#### Option A: Docker Compose (Fully Automated)
+If deploying via [`docker-compose.stdio.yml`](docker-compose.stdio.yml) or [`docker-compose.http.yml`](docker-compose.http.yml), migrations execute automatically prior to application launch via the `db-migrate` service:
+```bash
+docker compose -f docker-compose.stdio.yml up -d
+```
+
+#### Option B: Standalone Docker (External / Managed Database)
+Run migrations on a remote or standalone PostgreSQL instance without installing Python or cloning the repo:
+```bash
+docker run --rm \
+  -e DATABASE_URL="postgresql+asyncpg://<USER>:<PASSWORD>@<HOST>:<PORT>/<DB_NAME>" \
+  ghcr.io/aldrin-joan/quicklab-api:latest \
+  -m alembic upgrade head
+```
+
+#### Option C: Local Python / UV (Source Repository)
+If running from source:
+```bash
+uv run alembic upgrade head
+```
+
+> [!NOTE]
+> **Automatic Seed Data**: Once Alembic creates the schema, QuickLab's startup lifespan automatically seeds the 7 approved tabular ML models and ensures a default project workspace exists for the tenant.
+
+
 ---
 
 ### 2. Docker + HTTP
@@ -371,7 +400,24 @@ Connects to the ModelLab API service running inside Docker Compose (`docker comp
 ---
 
 ### 3. UVX + STDIO (Recommended Turnkey Setup)
-Runs QuickLab globally via `uvx` directly from PyPI:
+Runs QuickLab globally via `uvx` directly from PyPI.
+
+#### Zero-Configuration Mode (Zero Dependencies Required)
+If you don't have PostgreSQL or Docker installed, QuickLab automatically provisions an embedded SQLite database (`~/.quicklab/quicklab.db`), local filesystem artifact storage (`~/.quicklab/artifacts`), and an in-process queue:
+
+```json
+{
+  "mcpServers": {
+    "quicklab": {
+      "command": "uvx",
+      "args": ["quicklab-mcp"]
+    }
+  }
+}
+```
+
+#### Production Mode (Connecting to PostgreSQL & MinIO / S3)
+To connect QuickLab to your own PostgreSQL and S3-compatible storage:
 
 ```json
 {

{quicklab_mcp-0.1.0 → quicklab_mcp-0.2.1}/src/ml_mcp/__init__.py

@@ -1,3 +1,3 @@
 """Agentic ML MCP Server (ModelLab)."""
 
-__version__ = "0.1.0"
+__version__ = "0.2.1"

{quicklab_mcp-0.1.0 → quicklab_mcp-0.2.1}/src/ml_mcp/application/datasets/service.py

@@ -129,7 +129,9 @@ class DatasetService:
             ],
         }
 
-    async def list_datasets(self, tenant_id: str, project_id: str | None = None) -> list[dict[str, Any]]:
+    async def list_datasets(
+        self, tenant_id: str, project_id: str | None = None
+    ) -> list[dict[str, Any]]:
         datasets = await self.repo.list_datasets(tenant_id, project_id)
         return [
             {

{quicklab_mcp-0.1.0 → quicklab_mcp-0.2.1}/src/ml_mcp/application/datasets/validator.py

@@ -61,7 +61,9 @@ class DatasetValidator:
                 try:
                     text_content = raw_bytes.decode("utf-8")
                 except UnicodeDecodeError as exc:
-                    raise DatasetValidationError(f"Malformed encoding: dataset must be valid UTF-8: {exc}") from exc
+                    raise DatasetValidationError(
+                        f"Malformed encoding: dataset must be valid UTF-8: {exc}"
+                    ) from exc
 
                 reader = csv.reader(io.StringIO(text_content))
                 try:
@@ -89,7 +91,9 @@ class DatasetValidator:
             elif fmt == DatasetFormat.JSONL.value:
                 df = pd.read_json(bio, lines=True)
             else:
-                raise DatasetValidationError(f"Unsupported dataset format '{data_format}'. Allowed: csv, parquet, jsonl")
+                raise DatasetValidationError(
+                    f"Unsupported dataset format '{data_format}'. Allowed: csv, parquet, jsonl"
+                )
         except Exception as exc:
             raise DatasetValidationError(f"Failed to parse dataset as {fmt}: {exc}") from exc
 
@@ -148,7 +152,9 @@ class DatasetValidator:
         df.to_parquet(out_buf, index=False, engine="pyarrow", compression="snappy")
         return out_buf.getvalue()
 
-    def process(self, raw_bytes: bytes, data_format: DatasetFormat | str) -> tuple[pd.DataFrame, bytes, DatasetSchema]:
+    def process(
+        self, raw_bytes: bytes, data_format: DatasetFormat | str
+    ) -> tuple[pd.DataFrame, bytes, DatasetSchema]:
         """Validate, convert to canonical parquet, and extract complete schema."""
         df = self.parse_dataframe(raw_bytes, data_format)
         parquet_bytes = self.canonicalize_to_parquet(df)