72 lines
2.8 KiB
Markdown
72 lines
2.8 KiB
Markdown
# Open-Higgsfield AI 🎥✨
|
|
|
|
|
|
|
|
A local, open-source clone of **Higgsfield AI**, powered by [Muapi](https://muapi.ai) 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](https://vitejs.dev/) + Vanilla JavaScript for lightning-fast performance.
|
|
* **Styling**: Vanilla CSS (Custom Glassmorphism & Neon Design System).
|
|
* **API Integration**: [Muapi.ai](https://muapi.ai) (Vadoo Engine).
|
|
* **No Backend**: Runs entirely in the browser (Client-side API calls).
|
|
|
|
## 📦 Installation
|
|
|
|
1. Clone the repository:
|
|
```bash
|
|
git clone https://github.com/yourusername/open-higgsfield-ai.git
|
|
cd open-higgsfield-ai
|
|
```
|
|
|
|
2. Install dependencies:
|
|
```bash
|
|
npm install
|
|
```
|
|
|
|
3. Run the development server:
|
|
```bash
|
|
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](https://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.*
|