Wan2.1/wan-pwa
Claude 9a8fcf76cb
docs: add MCP Server setup guide for Claude Desktop integration
Added comprehensive MCP Server configuration guide to enable direct
file access between Claude Desktop and the Wan2.1 PWA project.

Features:
- Step-by-step installation for macOS, Windows, Linux
- Configuration examples with actual paths
- Verification and testing instructions
- Troubleshooting common issues
- Security best practices
- Advanced configuration options
- Comparison with current session workflow

This will help developers and collaborators set up persistent file
access for seamless development with Claude Desktop.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-24 14:45:06 +00:00
..
apps feat: Implement Phase 3 - Backend Integration & Critical Polish 2025-10-24 14:36:07 +00:00
packages/db feat: Implement Phase 3 - Backend Integration & Critical Polish 2025-10-24 14:36:07 +00:00
.eslintrc.js chore: add configuration files for monorepo setup 2025-10-24 14:19:02 +00:00
.gitignore feat: Add complete Wan2.1 PWA - AI Video Generation Platform 2025-10-24 14:18:18 +00:00
.prettierrc chore: add configuration files for monorepo setup 2025-10-24 14:19:02 +00:00
CONTRIBUTING.md feat: Add complete Wan2.1 PWA - AI Video Generation Platform 2025-10-24 14:18:18 +00:00
DEPLOYMENT.md feat: Add complete Wan2.1 PWA - AI Video Generation Platform 2025-10-24 14:18:18 +00:00
LICENSE feat: Add complete Wan2.1 PWA - AI Video Generation Platform 2025-10-24 14:18:18 +00:00
MCP_SERVER_SETUP.md docs: add MCP Server setup guide for Claude Desktop integration 2025-10-24 14:45:06 +00:00
package.json chore: add configuration files for monorepo setup 2025-10-24 14:19:02 +00:00
PHASE_3_IMPLEMENTATION.md feat: Implement Phase 3 - Backend Integration & Critical Polish 2025-10-24 14:36:07 +00:00
PROJECT_SUMMARY.md feat: Add complete Wan2.1 PWA - AI Video Generation Platform 2025-10-24 14:18:18 +00:00
README.md feat: Add complete Wan2.1 PWA - AI Video Generation Platform 2025-10-24 14:18:18 +00:00
SETUP.md feat: Add complete Wan2.1 PWA - AI Video Generation Platform 2025-10-24 14:18:18 +00:00
turbo.json chore: add configuration files for monorepo setup 2025-10-24 14:19:02 +00:00

Wan2.1 PWA - AI Video Generation Platform

A production-ready Progressive Web App for AI-powered video generation using Wan2.1 models.

Features

  • 🎨 Smart Prompt Engineering: 50+ templates with context-aware suggestions
  • 🎬 Video Generation: Text-to-Video and Image-to-Video
  • 📱 Progressive Web App: Installable, offline-capable
  • 🔐 Authentication: Supabase Auth with OAuth support
  • 💳 Credit System: Freemium model with usage tracking
  • Real-time Progress: WebSocket-based generation tracking
  • 🎯 Template Library: Categorized prompts (Cinematic, Animation, Realistic)
  • 📥 Download & Share: Export videos to device

Tech Stack

Frontend

  • Framework: Next.js 15 (App Router)
  • UI: shadcn/ui + Tailwind CSS
  • State: Zustand
  • Forms: React Hook Form + Zod
  • PWA: next-pwa

Backend

  • API: FastAPI (Python)
  • GPU: Replicate / Modal
  • Queue: Celery + Redis

Database

  • DB: Supabase (Postgres)
  • Auth: Supabase Auth
  • Storage: Supabase Storage
  • Cache: Upstash Redis

Project Structure

wan-pwa/
├── apps/
│   ├── web/          # Next.js frontend
│   └── api/          # FastAPI backend
├── packages/
│   ├── ui/           # Shared UI components
│   ├── db/           # Database schema & migrations
│   └── types/        # Shared TypeScript types
├── turbo.json        # Monorepo build config
└── package.json      # Root dependencies

Prerequisites

  • Node.js 18+
  • Python 3.10+
  • npm 9+
  • Supabase account
  • Replicate account

Setup

See SETUP.md for detailed instructions.

Quick Start

# Clone & Install
git clone <your-repo>
cd wan-pwa
npm install

# Start all services
npm run dev

# Frontend: http://localhost:3000
# Backend: http://localhost:8000

Development Commands

npm run dev          # Start all services
npm run build        # Build all packages
npm run lint         # Lint all packages
npm run test         # Run all tests
npm run clean        # Clean build artifacts
npm run format       # Format code with Prettier

Deployment

  • Frontend: Vercel
  • Backend: Modal or Railway
  • Database: Supabase

See DEPLOYMENT.md for detailed instructions.

Project Roadmap

  • Monorepo setup
  • Authentication flows
  • Prompt template system
  • T2V generation
  • I2V generation
  • Batch processing
  • Payment integration
  • Mobile app

Contributing

See CONTRIBUTING.md

License

MIT License - see LICENSE