Figura | Impressionist Pose Generator

📱 Now available as a Progressive Web App (PWA)! Install on your mobile device for easy access anywhere.

Figura is a web application that helps photographers, artists, and directors plan their shots. By uploading a reference image and specifying the number of male and female subjects, Figura uses advanced AI to overlay a clean, minimalist white line art sketch onto your scene, providing a perfect posing guide without altering the original background.

Features

• 📱 Progressive Web App: Install on your mobile device and use it like a native app
• 📸 Camera Integration: Take photos directly from your device camera
• 🖼️ Image Upload: Upload any reference photo or background scene
• 👥 Subject Specification: Choose the exact number of male and female subjects you want in the scene
• 🎨 AI-Powered Line Art: Generates a non-intrusive, white line sketch of the subjects posing naturally in your environment
• 🌄 Original Scene Preservation: The AI is strictly instructed to preserve your original background and lighting, only adding the pose instructions
• ↔️ Side-by-Side Comparison: Compare your original image with the generated posing guide
• 💾 Download: Save the generated posing guide directly to your device
• ⚡ Offline Ready: Service worker caches assets for faster loading

Tech Stack

• Frontend: React 19, Vite, Tailwind CSS, Framer Motion, Lucide React
• Backend: Node.js, Express (API Proxy)
• PWA: vite-plugin-pwa, Workbox (Service Worker)
• AI Models: Atlas Cloud API
  • Nano Banana Pro (default)
  • Nano Banana 2 (alternative option)

Prerequisites

• Node.js (v18 or higher recommended)
• An Atlas Cloud API Key

Getting Started

1. Clone the repository:

   git clone https://github.com/Alisa0808/Figura.git
   cd Figura

2. Install dependencies:

   npm install

3. Set up environment variables: Create a .env file in the root directory and add your Atlas Cloud API key:

   ATLAS_API_KEY=your_atlas_api_key_here

   (Note: You can also enter your API key directly in the app's UI via the settings menu at the bottom of the screen).

4. Start the development server:

   npm run dev

5. Open the app: Navigate to http://localhost:3000 in your browser.

Usage

1. Click the upload area to select a background image, or tap "Take Photo" to use your camera.
2. Use the "+" and "-" buttons to set the desired number of male and female subjects.
3. Click "Generate Posing Guide".
4. Wait for the AI to process the image.
5. View the result, compare it with the original, and click "Download Guide" to save it.

📱 Installing as a Mobile App

Figura can be installed on your mobile device like a native app!

iOS (Safari)

1. Open the app in Safari
2. Tap the Share button (square with arrow)
3. Scroll and tap "Add to Home Screen"
4. Tap "Add" - Figura will appear on your home screen!

Android (Chrome)

1. Open the app in Chrome
2. Tap the menu (three dots)
3. Tap "Add to Home screen" or "Install app"
4. Confirm by tapping "Install"

Once installed, you can use Figura offline and access your device camera directly!

For detailed PWA information, see PWA-GUIDE.md.

License

This project is open-source and available under the MIT License.