thejaswin123 / Face-Studio

Face Studio WebApp that gives multiple feature to user to color their lips, hairs and combined mix on giving image as input to the model.

Home Page:http://facestudio.herokuapp.com/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Face-Studio

A streamlit app which uses Instance Segmentation for Coloring Lips and Hair

Features

  • Lip Coloring
  • Hair Coloring
  • Eyeliner

Output

Lip Coloring

lips

Hair Coloring

hair

Eyeliner

eye

Installation

Python 3

  • Clone the repo using git clone <repo_url> (Note: GitBash should be installed in your system)
  • Create a virtual environment(using pip or anaconda) with python=3.6.13
  • Activate your environment
  • Install Cmake and Dlib seperately (More information given in notes)
  • Install the requirements.txt using pip install -r requirements.txt
  • Now from the CLI(Command Line Interface), navigate to the cloned folder
  • Enter streamlit run app.py in CLI to play with the webapp

Docker

  • Install Docker Desktop and configure it for your OS as per instruction on Docker Web Page.
  • To build the image,
    docker build -t <APP-NAME>:latest .
  • To run the docker image,
    docker run -p 8501:8501 <APP-NAME>:latest
  • If browser is not opening, Open Docker Desktop, You can see a container running with your <APP-NAME>. Click on Open in Browser option present with the container.

Deployment

Click Here to view the deployment.

Notes

Python 3

  • If you have trouble installing dlib, Click Here for a comprehensive installation guide.
  • If your OS is Windows, then install Visual Studio Installer and in it
    Installed > Visual Studio Community > Modify > Desktop Development with C++ > C++ Cmake tools for Windows
    and install it. Then proceed to the installation instructions.
  • In case you get an error installing dlib after the above step, try to install the packages in requirements.txt one by one with giving cmake precedence to dlib.

Docker

  • <APP-NAME> is the name of the app you are going to give to the docker image being built and the same app name is used for running the container.

About

Face Studio WebApp that gives multiple feature to user to color their lips, hairs and combined mix on giving image as input to the model.

http://facestudio.herokuapp.com/

License:MIT License


Languages

Language:Jupyter Notebook 79.6%Language:Python 20.1%Language:Dockerfile 0.2%Language:Shell 0.1%