VisionStudio AI

VisionStudio AI

Mobile-First PWA for AI Image Generation, Editing & Animation

Features • Quick Start • Architecture • Deployment • API • Contributing

---

Features

🎨 AI Image Generation

• Text-to-Image with FLUX, SDXL, Juggernaut XL
• 12+ Style Presets: Realistic, Anime, Cinematic, Fantasy, Fashion, Cyberpunk, and more
• Smart Prompt Enhancement with AI
• Negative Prompts for fine control
• Batch Generation (up to 4 images)
• Seed Control for reproducibility
• 5 Aspect Ratios: 1:1, 16:9, 9:16 (mobile-first), 4:5, 3:2

✏️ Advanced Image Editing

• Inpainting with brush mask (touch/stylus support)
• Object Removal — erase unwanted elements
• Background Removal/Replacement
• Face Restoration & Enhancement
• Skin Retouching
• Outfit Changing — casual to formal, seasonal styles
• Color Swapping
• Undo/Redo History Stack

🎬 Image to Animation

• 10 Animation Types: Blink, Smile, Head Motion, Talking, Lip Sync, Cinematic Zoom, 3D Parallax, Dance, Camera Pan, Background Motion
• Export Formats: MP4, WebM, GIF
• Adaptive Bitrate for mobile playback
• Audio Lip Sync support

📱 Progressive Web App

• Installable on Android (Add to Home Screen)
• Offline Support with Service Worker caching
• Background Sync for queued generation tasks
• Push Notifications for job completion
• Native App Feel with bottom navigation
• Touch-Optimized editing tools
• Gesture Support: pinch, drag, zoom

🔒 Security & Privacy

• JWT Authentication with refresh token rotation
• OAuth 2.0: Google, GitHub login
• Rate Limiting per device/IP
• Content Moderation for prompts and images
• Signed URLs for media access
• Mature Content Mode (18+) with PIN protection
• Encrypted Storage for sensitive content

🌍 Universal Access

• No Subscriptions — all features free
• No Paywalls — no locked tiers
• No Billing — completely free to use

---

Quick Start

Prerequisites

• Node.js 20+
• Python 3.11+
• Docker & Docker Compose (optional)
• GPU with CUDA 12.1+ (for AI inference)

One-Command Setup

git clone https://github.com/visionstudio/visionstudio-ai.git
cd visionstudio-ai
./setup.sh

Manual Setup

Frontend:

cd frontend
npm install
npm run db:seed
npm run dev

Backend:

cd backend
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
alembic upgrade head
python seed.py
uvicorn app.main:app --reload

GPU Worker:

cd gpu-worker
pip install torch diffusers transformers
python main.py

Docker (Full Stack):

docker-compose up --build

---

Architecture

┌─────────────────────────────────────────────────────────────┐
│                         CLIENT (PWA)                         │
│  Next.js 14 • React 18 • TypeScript • Tailwind CSS          │
│  Framer Motion • Zustand • Service Worker • IndexedDB       │
└──────────────────────────┬──────────────────────────────────┘
                           │ HTTPS / WSS
┌──────────────────────────┴──────────────────────────────────┐
│                        API GATEWAY                           │
│  Nginx • Rate Limiting • SSL Termination • Load Balancing   │
└──────────────────────────┬──────────────────────────────────┘
                           │
        ┌──────────────────┼──────────────────┐
        │                  │                  │
┌───────▼──────┐  ┌────────▼────────┐  ┌─────▼──────┐
│   Frontend   │  │  FastAPI        │  │  WebSocket │
│   (Next.js)  │  │  (Python)       │  │  (Real-time│
│              │  │                 │  │   updates) │
└──────────────┘  └────────┬────────┘  └────────────┘
                           │
        ┌──────────────────┼──────────────────┐
        │                  │                  │
┌───────▼──────┐  ┌────────▼────────┐  ┌─────▼──────┐
│  PostgreSQL  │  │  Redis          │  │  R2/S3     │
│  (Primary)   │  │  (Cache/Queue)  │  │  (Storage) │
└──────────────┘  └─────────────────┘  └────────────┘
                           │
                    ┌──────▼──────┐
                    │  Celery     │
                    │  Workers    │
                    └──────┬──────┘
                           │
                    ┌──────▼──────┐
                    │  GPU Worker │
                    │  (CUDA)     │
                    │  FLUX/SDXL  │
                    └─────────────┘

---

Tech Stack

Layer	Technology
Frontend	Next.js 14, React 18, TypeScript
Styling	Tailwind CSS, CSS Custom Properties
Animations	Framer Motion
State	Zustand, React Query
Auth	NextAuth.js, JWT
Backend	FastAPI, SQLAlchemy, Celery
Database	PostgreSQL 15
Cache/Queue	Redis 7
Storage	Cloudflare R2 / AWS S3
AI Models	FLUX, SDXL, AnimateDiff, LivePortrait
Deploy	Docker, Kubernetes, Terraform
Monitoring	Prometheus, Grafana
Testing	Vitest, Playwright, pytest

---

Deployment

Docker Compose (Recommended)

docker-compose up --build

Kubernetes

kubectl apply -f k8s/

Terraform (AWS + Cloudflare)

cd terraform
terraform init
terraform plan
terraform apply

See DEPLOYMENT.md for detailed instructions.

---

API

Authentication

POST /api/auth/register
POST /api/auth/token
GET  /api/auth/me

Generation

POST /api/generate/
GET  /api/generate/{jobId}
POST /api/generate/enhance

Editing

POST /api/edit/
GET  /api/edit/{jobId}

Animation

POST /api/animate/
GET  /api/animate/{jobId}

See API_DOCUMENTATION.md for complete reference.

---

Scaling

Phase	Users	Monthly Cost
MVP	10K	$100
Growth	100K	$1,500
Scale	500K	$8,000
Global	1M	$20,000

See SCALING.md for the full roadmap.

---

Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

Development Commands

# Frontend
npm run dev          # Dev server
npm run build        # Production build
npm run test         # Unit tests
npm run test:e2e     # E2E tests
npm run storybook    # Component docs

# Backend
uvicorn app.main:app --reload   # Dev server
pytest                          # Run tests
alembic upgrade head            # Run migrations
black app/                      # Format code

# Full stack
docker-compose up --build       # Start everything
./scripts/deploy.sh production  # Deploy to production
./scripts/health-check.sh       # Check system health

---

Security

If you discover a security vulnerability, please email security@visionstudio.app instead of opening a public issue. See SECURITY.md for details.

---

License

MIT License — Free for personal and commercial use.

---

Built with ❤️ by the VisionStudio AI Team