Open-Generative-AI/README.md

2.8 KiB

Open-Higgsfield AI 🎥

Open-Higgsfield Banner

A local, open-source clone of Higgsfield AI, powered by Muapi for high-end video and image generation. This project aims to replicate the premium experience of Higgsfield's studios locally, giving you control over your creative workflow with your own API keys.

🚀 Features

1. AI Image Studio 🎨

  • High-Fidelity Generation: Create stunning visuals using top-tier models like Flux.1 Dev and SDXL.
  • Advanced Controls: Fine-tune your output with negative prompts, aspect ratio selection (1:1, 16:9, 9:16), and seed control.
  • Gallery: Persistent history of your generations.

2. AI Video Studio 🎬

  • Text-to-Video (T2V): Turn your scripts into cinematic videos using models like Wan 2.5 and Google Veo.
  • Image-to-Video (I2V): Bring static images to life with motion.
  • Motion Buckets: Control the intensity of movement (Static, Gentle, Dynamic).

3. Cinema Studio 🎥

  • Pro Camera Controls: Simulate real manufacturing lenses (e.g., Studio Digital S35).
  • Physical Movements: Control Zoom, Pan, Tilt, and Roll just like a real camera.
  • Directors Mode: Precise keyframing for camera trajectories (Coming Soon).

4. Soul ID & Lipsync 🗣️

  • Character Consistency: Maintain character identity across multiple generations.
  • Lipsync Studio: Upload an audio file or type text to make your characters speak with perfect lip synchronization.

🛠️ Tech Stack

  • Frontend: Vite + Vanilla JavaScript for lightning-fast performance.
  • Styling: Vanilla CSS (Custom Glassmorphism & Neon Design System).
  • API Integration: Muapi.ai (Vadoo Engine).
  • No Backend: Runs entirely in the browser (Client-side API calls).

📦 Installation

  1. Clone the repository:

    git clone https://github.com/yourusername/open-higgsfield-ai.git
    cd open-higgsfield-ai
    
  2. Install dependencies:

    npm install
    
  3. Run the development server:

    npm run dev
    
  4. Open http://localhost:5173 in your browser.

🔑 Configuration

To use the generation features, you need a Muapi API Key.

  1. Go to Muapi.ai Dashboard and generate a key.
  2. Open the app settings (Gear icon).
  3. Paste your API Key. It defaults to browser localStorage for security.

🛣️ Roadmap

  • Phase 1: AI Image Studio (Flux Integration)
  • Phase 2: AI Video Studio (Wan/Veo Integration)
  • Phase 3: Cinema Studio (Camera Motion Controls)
  • Phase 4: Soul ID & Lipsync Implementation

Disclaimer: This is a community project and is not affiliated with Higgsfield AI. Usage costs are dependent on your Muapi API usage.