https://github.com/michael660-max/realify
Turn quick face sketches into photorealistic 2D portraits and interactive 3D models
https://github.com/michael660-max/realify
fastapi figma htmlcssjs python3 react shell-script three-js
Last synced: 3 months ago
JSON representation
Turn quick face sketches into photorealistic 2D portraits and interactive 3D models
- Host: GitHub
- URL: https://github.com/michael660-max/realify
- Owner: Michael660-max
- License: mit
- Created: 2025-04-16T01:13:54.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-06-07T22:21:54.000Z (8 months ago)
- Last Synced: 2025-06-24T04:39:52.172Z (7 months ago)
- Topics: fastapi, figma, htmlcssjs, python3, react, shell-script, three-js
- Language: JavaScript
- Homepage:
- Size: 13.8 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Citation: CITATION.bib
Awesome Lists containing this project
README
# REALIFY
Transform your roughest scribbles to realistic face potraits, and turn those into an interactive 3d model.
## Demo Video
https://github.com/user-attachments/assets/23916501-df8a-43fc-8484-706a3fc0679b
## Realify UI
### Realify 2D pipeline
### Realify 3D model
### Other Examples
---
## How It Works
1. **Scribble:** Draw freely on the 2D canvas. Includes draw, fill, and erase tools.
2. **realify:** Use the “realify” button to transform scribble into realistic photograph of a face
3. **REALIFY:** Click “REALIFY” to convert your photograph into a 3D model
4. **Iterate:** Draw another face and repeat!
---
## Quick Start
### Prerequisites
- Conda venv
- Libraries in requirement.txt
- Controlnet diffusion model
### Program Setup
```bash
python3 -m pip install -r requirements.txt
source ~/miniconda3/etc/profile.d/conda.sh
conda activate face3d
```
### Frontend Setup
```bash
cd frontend
npm start
```
### Backend Setup
```bash
cd backend
python3 -m uvicorn main:app --reload
```
---
## Architecture
### Frontend
- **React:** Clean, responsive UI
- **Three.js:** Interactive 3D model
- **Figma:** Initial UI design
- **Html Css, Node.js:** Styling and animations
### Backend
- **FastAPI:** Quick API frameowrk
- **Mediapipe:** 3D inferencing
- **Bash:** Convenient installation