realify

Turn quick face sketches into photorealistic 2D portraits and interactive 3D models

https://github.com/michael660-max/realify

Science Score: 44.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
  • Committers with academic emails
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (6.1%) to scientific vocabulary

Keywords

fastapi figma htmlcssjs python3 react shell-script three-js
Last synced: 4 months ago · JSON representation ·

Repository

Turn quick face sketches into photorealistic 2D portraits and interactive 3D models

Basic Info
  • Host: GitHub
  • Owner: Michael660-max
  • License: mit
  • Language: JavaScript
  • Default Branch: main
  • Homepage:
  • Size: 13.8 MB
Statistics
  • Stars: 0
  • Watchers: 1
  • Forks: 0
  • Open Issues: 0
  • Releases: 0
Topics
fastapi figma htmlcssjs python3 react shell-script three-js
Created 8 months ago · Last pushed 7 months ago
Metadata Files
Readme License Citation

README.md

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 Canvas UI

Realify 2D pipeline

Vibe Draw 2D Canvas

Realify 3D model

Vibe Draw 3D World

Other Examples

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

Owner

  • Name: Michael Chang
  • Login: Michael660-max
  • Kind: user

uni student who likes coding.

Citation (CITATION.bib)

@misc{zhang2023adding,
  title        = {Adding Conditional Control to Text-to-Image Diffusion Models},
  author       = {Lvmin Zhang and Anyi Rao and Maneesh Agrawala},
  booktitle    = {IEEE International Conference on Computer Vision (ICCV)},
  year         = {2023},
}

GitHub Events

Total
  • Push event: 7
Last Year
  • Push event: 7

Committers

Last synced: 7 months ago

All Time
  • Total Commits: 33
  • Total Committers: 1
  • Avg Commits per committer: 33.0
  • Development Distribution Score (DDS): 0.0
Past Year
  • Commits: 33
  • Committers: 1
  • Avg Commits per committer: 33.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
Michael Chang M****4@g****m 33

Issues and Pull Requests

Last synced: 7 months ago


Dependencies

frontend/package-lock.json npm
  • 1316 dependencies
frontend/package.json npm
  • @react-three/drei ^10.0.8
  • @react-three/fiber ^9.1.2
  • @testing-library/dom ^10.4.0
  • @testing-library/jest-dom ^6.6.3
  • @testing-library/react ^16.3.0
  • @testing-library/user-event ^13.5.0
  • react ^19.1.0
  • react-dom ^19.1.0
  • react-scripts 5.0.1
  • three ^0.176.0
  • web-vitals ^2.1.4
package-lock.json npm
  • @types/draco3d 1.4.10
  • @types/offscreencanvas 2019.7.3
  • @types/webxr 0.5.22
  • draco3d 1.5.7
  • fflate 0.6.10
  • potpack 1.0.2
  • three 0.176.0
  • three-stdlib 2.36.0
package.json npm
  • three ^0.176.0
  • three-stdlib ^2.36.0
requirements.txt pypi
  • accelerate >=0.21.0
  • controlnet-aux *
  • diffusers >=0.24.0
  • fastapi *
  • huggingface-hub >=0.21.0
  • numpy *
  • open3d *
  • opencv-python *
  • pillow *
  • python-multipart *
  • safetensors *
  • timm *
  • torch *
  • torchvision *
  • transformers >=4.51.0
  • uvicorn *