@weirdfingers/baseboards 0.9.6 → 0.9.7

package/package.json

@@ -1,14 +1,13 @@
 {
   "name": "@weirdfingers/baseboards",
-  "version": "0.9.6",
+  "version": "0.9.7",
   "description": "One-command launcher for the Boards image generation application",
   "type": "module",
   "bin": {
     "baseboards": "./dist/index.js"
   },
   "files": [
-    "dist",
-    "templates"
+    "dist"
   ],
   "keywords": [
     "boards",
@@ -61,8 +60,6 @@
     "vitest": "^1.6.0"
   },
   "scripts": {
-    "prepare-templates": "node scripts/prepare-templates.js",
-    "prebuild": "pnpm run prepare-templates",
     "build": "tsup && node scripts/add-shebang.js",
     "dev": "tsup --watch",
     "test": "vitest --run",

package/templates/README.md

@@ -1,122 +0,0 @@
-# Baseboards - Image Generation Platform
-
-This is a self-hosted Baseboards installation, scaffolded by the Baseboards CLI.
-
-## Quick Start
-
-### Prerequisites
-
-- Docker Desktop (macOS/Windows) or Docker Engine (Linux)
-- Node.js 20+
-
-### First-Time Setup
-
-1. **Configure API Keys** (Required)
-
-   Edit `api/.env` and add at least one provider API key:
-
-   ```bash
-   # Get your API keys from:
-   # - Replicate: https://replicate.com/account/api-tokens
-   # - FAL: https://fal.ai/dashboard/keys
-   # - KIE: https://kie.ai/dashboard
-   # - OpenAI: https://platform.openai.com/api-keys
-   # - Google: https://makersuite.google.com/app/apikey
-
-   REPLICATE_API_KEY=r8_...
-   FAL_KEY=...
-   KIE_API_KEY=...
-   OPENAI_API_KEY=sk-...
-   GOOGLE_API_KEY=...
-   ```
-
-2. **Start the application**
-
-   ```bash
-   npx @weirdfingers/baseboards up
-   ```
-
-3. **Access the app**
-
-   Open http://localhost:3300 in your browser
-
-## Commands
-
-```bash
-# Start the application
-npx @weirdfingers/baseboards up
-
-# Start in detached mode (background)
-npx @weirdfingers/baseboards up --detached
-
-# Stop the application
-npx @weirdfingers/baseboards down
-
-# View logs
-npx @weirdfingers/baseboards logs
-
-# View specific service logs
-npx @weirdfingers/baseboards logs api
-
-# Check status
-npx @weirdfingers/baseboards status
-
-# Update to latest version
-npx @weirdfingers/baseboards update
-
-# Clean up (removes volumes and containers)
-npx @weirdfingers/baseboards clean --hard
-```
-
-## Configuration
-
-### Generators
-
-Edit `api/config/generators.yaml` to:
-
-- Enable/disable specific image generation providers
-- Add custom Replicate models
-- Configure provider-specific settings
-
-### Storage
-
-Edit `api/config/storage_config.yaml` to:
-
-- Switch from local storage to S3/GCS/Cloudflare R2
-- Configure CDN integration
-- Set up routing rules for different file types
-
-Generated media is stored in `data/storage/` by default.
-
-## Development
-
-### Hot Reload
-
-The default development mode includes hot reload for both frontend and backend:
-
-- Frontend: Next.js Fast Refresh
-- Backend: uvicorn --reload
-
-Changes to source code are reflected immediately.
-
-### Custom Code
-
-You can customize any part of the application:
-
-- Frontend: `web/src/`
-- Backend: `api/src/`
-
-**Note:** When you run `update`, custom code changes will be overwritten.
-Use git to track your modifications.
-
-## Documentation
-
-- Full documentation: https://baseboards.dev/docs
-- Adding providers: https://baseboards.dev/docs/generators
-- Storage configuration: https://baseboards.dev/docs/storage
-- Auth setup: https://baseboards.dev/docs/auth
-
-## Support
-
-- GitHub Issues: https://github.com/weirdfingers/boards/issues
-- Documentation: https://baseboards.dev

package/templates/api/.env.example

@@ -1,65 +0,0 @@
-# Backend Environment Variables
-# Note: Database and Redis URLs are set in docker/.env
-
-# API Port (must match docker-compose port mapping)
-BOARDS_API_PORT=8800
-
-# CORS Origins (allow frontend to access API)
-BOARDS_CORS_ORIGINS=["http://localhost:3300"]
-
-# JWT Secret (will be generated by CLI)
-BOARDS_JWT_SECRET=
-
-# ============================================
-# PROVIDER API KEYS (ADD AT LEAST ONE!)
-# ============================================
-
-# Replicate - https://replicate.com/account/api-tokens
-REPLICATE_API_TOKEN=
-
-# FAL - https://fal.ai/dashboard/keys
-FAL_KEY=
-
-# KIE - https://kie.ai/dashboard
-KIE_API_KEY=
-
-# OpenAI - https://platform.openai.com/api-keys
-OPENAI_API_KEY=
-
-# Google AI - https://makersuite.google.com/app/apikey
-GOOGLE_API_KEY=
-
-# ============================================
-# AUTH PROVIDER
-# ============================================
-# For local development, 'none' allows unauthenticated access
-# For production, configure a proper provider (clerk, supabase, auth0, jwt)
-BOARDS_AUTH_PROVIDER=none
-
-# Clerk
-# BOARDS_AUTH_PROVIDER=clerk
-# CLERK_SECRET_KEY=sk_test_...
-
-# Supabase
-# BOARDS_AUTH_PROVIDER=supabase
-# SUPABASE_URL=https://xxx.supabase.co
-# SUPABASE_SERVICE_KEY=...
-
-# Auth0
-# BOARDS_AUTH_PROVIDER=auth0
-# AUTH0_DOMAIN=...
-# AUTH0_CLIENT_ID=...
-# AUTH0_CLIENT_SECRET=...
-
-# ============================================
-# CONFIGURATION
-# ============================================
-
-# Config file paths
-BOARDS_STORAGE_CONFIG_PATH=./config/storage_config.yaml
-BOARDS_GENERATORS_CONFIG_PATH=./config/generators.yaml
-
-# Storage (if using cloud storage)
-# AWS_ACCESS_KEY_ID=
-# AWS_SECRET_ACCESS_KEY=
-# GCP_SERVICE_ACCOUNT_JSON=

package/templates/api/ARTIFACT_RESOLUTION_GUIDE.md

@@ -1,148 +0,0 @@
-# Artifact Resolution Guide
-
-This guide explains how artifact resolution works in the Boards generator system.
-
-## Overview
-
-Generators can accept artifacts (images, videos, audio, etc.) from previous generations as inputs. The artifact resolution system automatically converts generation ID strings (UUIDs) into typed artifact objects with proper validation.
-
-## How It Works
-
-### Automatic Type Introspection
-
-The system uses Pydantic type introspection to automatically detect which fields are artifacts. **No manual configuration needed!**
-
-```python
-from pydantic import BaseModel, Field
-from boards.generators.artifacts import ImageArtifact, VideoArtifact
-
-class MyGeneratorInput(BaseModel):
-    """Input schema for my generator."""
-
-    prompt: str = Field(description="Text prompt")
-
-    # These are automatically detected as artifact fields
-    image_source: ImageArtifact = Field(description="Input image")
-    video_sources: list[VideoArtifact] = Field(description="Input videos")
-
-    # Regular fields are ignored
-    num_outputs: int = Field(default=1, ge=1, le=10)
-```
-
-That's it! No decorators, no class variables, no manual registration needed.
-
-### What Happens Automatically
-
-When a generation is submitted with input parameters like:
-
-```json
-{
-  "prompt": "enhance the colors",
-  "image_source": "550e8400-e29b-41d4-a716-446655440000",
-  "video_sources": [
-    "7c9e6679-7425-40de-944b-e07fc1f90ae7",
-    "8f9e6679-7425-40de-944b-e07fc1f90ae8"
-  ]
-}
-```
-
-The system:
-
-1. **Detects** that `image_source` and `video_sources` are artifact fields (via type introspection)
-2. **Queries** the database to fetch the generations by ID
-3. **Validates** each generation:
-   - Belongs to the same tenant (access control)
-   - Has status="completed" (can't use pending generations)
-   - Has the correct artifact type (can't use a video where an image is expected)
-4. **Converts** generation records to typed artifact objects
-5. **Validates** the input with Pydantic
-
-All of this happens automatically in [actors.py](src/boards/workers/actors.py).
-
-## Supported Patterns
-
-### Single Artifact
-
-```python
-image_source: ImageArtifact = Field(...)
-```
-
-**Input**: Single generation ID string (e.g., `"550e8400-e29b-41d4-a716-446655440000"`)
-**Output**: Single `ImageArtifact` object
-
-### List of Artifacts
-
-```python
-image_sources: list[ImageArtifact] = Field(min_length=1)
-```
-
-**Input**: List of generation ID strings (e.g., `["id1", "id2"]`)
-**Output**: List of `ImageArtifact` objects (always a list, even if input has one ID)
-
-**Important**: If the field type is `list[ImageArtifact]`, the resolved value will ALWAYS be a list, even if only one generation ID is provided. The system respects the type annotation.
-
-### Optional Artifacts
-
-```python
-reference_image: ImageArtifact | None = Field(default=None)
-```
-
-Field can be omitted or set to `null`.
-
-## Supported Artifact Types
-
-- `ImageArtifact` - Images (PNG, JPEG, WebP, etc.)
-- `VideoArtifact` - Videos (MP4, WebM, etc.)
-- `AudioArtifact` - Audio files (MP3, WAV, etc.)
-- `TextArtifact` - Text content
-
-## Error Handling
-
-The system provides clear error messages when validation fails:
-
-- `"Generation {id} not found"` - Invalid generation ID
-- `"Access denied to generation {id} - tenant mismatch"` - User doesn't own this generation
-- `"Generation {id} is not completed (status: pending)"` - Can't use incomplete generations
-- `"Generation {id} has wrong artifact type: expected image, got video"` - Type mismatch
-
-## Examples
-
-### Image-to-Image Editor
-
-```python
-class ImageEditInput(BaseModel):
-    prompt: str = Field(description="Editing instructions")
-    image_source: ImageArtifact = Field(description="Image to edit")
-    strength: float = Field(default=0.8, ge=0.0, le=1.0)
-```
-
-### Multi-Image Collage
-
-```python
-class CollageInput(BaseModel):
-    images: list[ImageArtifact] = Field(
-        description="Images to combine",
-        min_length=2,
-        max_length=9
-    )
-    layout: Literal["grid", "freeform"] = Field(default="grid")
-```
-
-### Video + Audio Mixer
-
-```python
-class VideoAudioMixInput(BaseModel):
-    video_source: VideoArtifact = Field(description="Video track")
-    audio_source: AudioArtifact = Field(description="Audio track")
-    volume: float = Field(default=1.0, ge=0.0, le=2.0)
-```
-
-## Implementation Details
-
-The automatic detection is handled by:
-
-- [`extract_artifact_fields()`](src/boards/generators/artifact_resolution.py) - Introspects schema to find artifact fields
-- [`resolve_input_artifacts()`](src/boards/generators/artifact_resolution.py) - Resolves generation IDs to artifacts
-- [`resolve_generation_ids_to_artifacts()`](src/boards/generators/artifact_resolution.py) - Database queries and validation
-
-See [artifact_resolution.py](src/boards/generators/artifact_resolution.py) for the full implementation.

package/templates/api/Dockerfile

@@ -1,32 +0,0 @@
-FROM python:3.12-slim
-
-WORKDIR /app
-
-# Install system dependencies
-RUN apt-get update && apt-get install -y \
-    curl \
-    build-essential \
-    && rm -rf /var/lib/apt/lists/*
-
-# Install uv
-RUN pip install --no-cache-dir uv
-
-# Copy application code first (needed for version detection in pyproject.toml)
-COPY . .
-
-# Install Python dependencies with all generator providers
-RUN uv pip install --system --no-cache-dir .[generators-all]
-
-# Create non-root user
-RUN useradd -m -u 1001 apiuser && chown -R apiuser:apiuser /app
-USER apiuser
-
-# Expose port
-EXPOSE 8800
-
-# Health check
-HEALTHCHECK --interval=30s --timeout=3s --start-period=40s --retries=3 \
-  CMD curl -f http://localhost:8800/health || exit 1
-
-# Start the application
-CMD ["uvicorn", "boards.api.app:app", "--host", "0.0.0.0", "--port", "8800"]

package/templates/api/README.md

@@ -1,264 +0,0 @@
-# Boards Backend
-
-Backend for the Boards open-source creative toolkit for AI-generated content.
-
-## Features
-
-- 🎨 Multi-provider support (Replicate, Fal.ai, OpenAI, etc.)
-- 🔌 Pluggable architecture for generators and providers
-- 📊 GraphQL API with Strawberry
-- 🗄️ PostgreSQL with SQLAlchemy 2.0
-- 🔄 Migrations with Alembic (async) and timestamped filenames
-- 👥 Multi-tenant support with tenant isolation
-- 🔐 Pluggable authentication (Supabase, Clerk, Auth0, JWT)
-- 📦 Flexible storage backends (Local, S3, GCS, Supabase)
-
-## Installation
-
-### Minimal Install
-
-The minimal installation includes core functionality with local filesystem storage only:
-
-```bash
-pip install weirdfingers-boards
-```
-
-### Install with Specific Generators
-
-Install only the generator providers you need:
-
-```bash
-# OpenAI generators (DALL-E 3, Whisper)
-pip install weirdfingers-boards[generators-openai]
-
-# Replicate generators (Flux Pro, Lipsync)
-pip install weirdfingers-boards[generators-replicate]
-
-# fal.ai generators (nano-banana)
-pip install weirdfingers-boards[generators-fal]
-
-# Multiple generators
-pip install weirdfingers-boards[generators-openai,generators-replicate]
-
-# All generators
-pip install weirdfingers-boards[generators-all]
-```
-
-### Install with Storage Backends
-
-Add cloud storage providers as needed:
-
-```bash
-# S3 storage (AWS, MinIO, DigitalOcean Spaces)
-pip install weirdfingers-boards[storage-s3]
-
-# Supabase storage
-pip install weirdfingers-boards[storage-supabase]
-
-# Google Cloud Storage
-pip install weirdfingers-boards[storage-gcs]
-
-# All storage backends
-pip install weirdfingers-boards[storage-all]
-```
-
-### Full Installation
-
-Install everything (all generators and storage backends):
-
-```bash
-pip install weirdfingers-boards[all]
-```
-
-### Development Installation
-
-For local development with all providers for type checking and testing:
-
-```bash
-# Clone the repository
-git clone https://github.com/weirdfingers/boards.git
-cd boards/packages/backend
-
-# Install with dev dependencies (includes all providers)
-uv sync
-```
-
-## Configuration
-
-Copy `.env.example` to `.env` and configure your settings:
-
-```bash
-cp .env.example .env
-```
-
-Key configuration options:
-
-- `BOARDS_DATABASE_URL`: PostgreSQL connection string (e.g. postgresql://user:pass@localhost:5433/db)
-- `BOARDS_REDIS_URL`: Redis connection for job queue
-- `BOARDS_STORAGE_PROVIDER`: Storage backend (local, s3, gcs, supabase)
-- `BOARDS_AUTH_PROVIDER`: Authentication provider
-
-## Database Setup
-
-### 1. Create the database
-
-```bash
-createdb boards_dev
-```
-
-### 2. Apply initial schema via Alembic
-
-```bash
-# Use Alembic to create all tables
-uv run alembic upgrade head
-```
-
-## Development
-
-### Quick Start
-
-```bash
-# Start the API server (after installation and configuration)
-boards-server
-
-# Run database migrations
-boards-migrate upgrade head
-
-# Start background workers
-boards-worker
-```
-
-### Development Server
-
-```bash
-# Using uvicorn directly
-uvicorn boards.api.app:app --reload --port 8088
-
-# Or using the module
-python -m boards.api.app
-```
-
-### Access the GraphQL playground
-
-Open http://localhost:8088/graphql in your browser.
-
-### Database migrations
-
-When you need to change the database schema, use Alembic.
-
-```bash
-# Create a new migration (autogenerate from models in boards.dbmodels)
-uv run alembic revision -m "add feature" --autogenerate
-
-# Apply latest migrations
-uv run alembic upgrade head
-
-# Roll back one revision
-uv run alembic downgrade -1
-```
-
-📖 For detailed migration workflow, see docs and examples under `apps/docs`.
-
-## Project Structure
-
-```
-packages/backend/
-├── alembic/                 # Alembic migration scripts
-│   └── versions/            # Timestamped revision files
-├── alembic.ini              # Alembic config
-├── src/boards/
-│   ├── api/                 # FastAPI application
-│   ├── dbmodels/            # SQLAlchemy ORM models (authoritative)
-│   ├── database/            # Connection helpers and compatibility shim
-│   ├── graphql/             # GraphQL schema and resolvers
-│   ├── providers/           # Provider implementations
-│   ├── generators/          # Generator implementations
-│   ├── storage/             # Storage backends
-│   └── config.py            # Configuration management
-└── tests/
-```
-
-## Community & Social
-
-Join the Weirdfingers community:
-
-- **TikTok**: [https://www.tiktok.com/@weirdfingers](https://www.tiktok.com/@weirdfingers)
-- **X (Twitter)**: [https://x.com/_Weirdfingers_](https://x.com/_Weirdfingers_)
-- **YouTube**: [https://www.youtube.com/@Weirdfingers](https://www.youtube.com/@Weirdfingers)
-- **Discord**: [https://discord.gg/rvVuHyuPEx](https://discord.gg/rvVuHyuPEx)
-- **Instagram**: [https://www.instagram.com/_weirdfingers_/](https://www.instagram.com/_weirdfingers_/)
-## Testing
-
-Boards uses pytest for testing with both unit tests (mocked) and optional live API tests.
-
-### Running Tests
-
-```bash
-# Run all unit tests (excludes live API tests)
-make test-backend
-
-# Or using pytest directly
-cd packages/backend
-uv run pytest tests/
-
-# Run with coverage
-uv run pytest tests/ --cov=src/boards --cov-report=html
-
-# Run specific test file
-uv run pytest tests/generators/implementations/test_flux_pro.py -v
-```
-
-### Unit Tests vs Live API Tests
-
-**Unit tests** (default):
-- Use mocked provider SDKs
-- Fast and free
-- Run automatically in CI/CD
-- Located: `tests/**/test_*.py`
-
-**Live API tests** (opt-in only):
-- Make real API calls to providers
-- Consume API credits
-- **Never run by default**
-- Located: `tests/**/test_*_live.py`
-
-### Running Live API Tests
-
-Live tests verify real connectivity with provider APIs but cost money. They are **excluded from default test runs**.
-
-```bash
-# Set up API key
-export BOARDS_GENERATOR_API_KEYS='{"REPLICATE_API_TOKEN": "r8_..."}'
-
-# Run a specific generator's live test
-uv run pytest tests/generators/implementations/test_flux_pro_live.py -v -m live_api
-
-# Run all live tests for one provider
-uv run pytest -m live_replicate -v
-
-# Run all live tests (not recommended - expensive!)
-uv run pytest -m live_api -v
-```
-
-For detailed information on live API testing, see:
-- [Live API Testing Guide](docs/TESTING_LIVE_APIS.md)
-- [Generator Testing Documentation](../../apps/docs/docs/generators/testing.md)
-
-### Test Organization
-
-```
-tests/
-├── conftest.py                              # Shared fixtures (database, etc.)
-├── generators/
-│   └── implementations/
-│       ├── conftest.py                      # Generator-specific fixtures
-│       ├── test_flux_pro.py                 # Unit tests (mocked)
-│       ├── test_flux_pro_live.py           # Live API tests (opt-in)
-│       └── ...
-├── graphql/                                 # GraphQL API tests
-└── storage/                                 # Storage backend tests
-```
-
-## License
-
-MIT