initial

app.py

@@ -0,0 +1,252 @@
+import os
+from io import BytesIO
+
+import gradio as gr
+import grpc
+from PIL import Image
+import pandas as pd
+
+from inference_pb2 import SFERequest, SFEResponse, SFERequestMask, SFEResponseMask
+from inference_pb2_grpc import SFEServiceStub
+
+PREDEFINED_EDITINGS_LIST = [
+    "glasses", 
+    "smile", 
+    "makeup", 
+    "eye_openness",
+    "trimmed_beard",
+    "lipstick",
+    "face_roundness",
+    "nose_length",
+    "eyebrow_thickness",
+    "displeased",
+    "age",
+    "rotation",
+    "afro",
+    "angry",
+    "bobcut",
+    "bowlcut",
+    "mohawk",
+    "curly_hair",
+    "purple_hair",
+    "surprised",
+    "beyonce",
+    "hilary_clinton",
+    "depp",
+    "taylor_swift",
+    "trump",
+    "zuckerberg",
+    "black hair",
+    "blond hair",
+    "grey hair",
+    "wavy hair",
+    "receding hairline",
+    "sideburns",
+    "goatee",
+    "earrings",
+    "gender"
+]
+
+DIRECTIONS_NAME_SWAP = {
+    "smile" : "fs_smiling",
+    "glasses": "fs_glasses",
+    "makeup": "fs_makeup",
+}
+
+
+def get_bytes(img):
+    if img is None:
+        return img
+
+    buffered = BytesIO()
+    img.save(buffered, format="JPEG")
+    return buffered.getvalue()
+
+
+def bytes_to_image(image: bytes) -> Image.Image:
+    image = Image.open(BytesIO(image))
+    return image
+
+
+def edit_image(orig_image, edit_direction, edit_power, align, mask, progress=gr.Progress(track_tqdm=True)):
+    if edit_direction in DIRECTIONS_NAME_SWAP:
+        edit_direction = DIRECTIONS_NAME_SWAP[edit_direction]
+    if not orig_image:
+        return gr.update(visible=False), gr.update(visible=False), gr.update(value="Need to upload an input image ❗", visible=True)
+
+    orig_image_bytes = get_bytes(orig_image)
+    mask_bytes = get_bytes(mask)
+    if mask_bytes is None:
+        mask_bytes = b"mask" 
+
+    with grpc.insecure_channel(os.environ['SERVER']) as channel:
+        stub = SFEServiceStub(channel)
+
+        output: SFEResponse = stub.edit(
+            SFERequest(orig_image=orig_image_bytes, direction=edit_direction, power=edit_power, align=align, mask=mask_bytes, use_cache=True)
+        )
+
+    if output.image == b"aligner error":
+        return gr.update(visible=False), gr.update(visible=False), gr.update(value="Face aligner can not find face in your image 😢 Try to upload another one", visible=True)
+
+    output_edited = bytes_to_image(output.image)
+    output_inv = bytes_to_image(output.inv_image)
+    return gr.update(value=output_edited, visible=True), gr.update(value=output_inv, visible=True), gr.update(visible=False)
+
+
+def edit_image_clip(orig_image, neutral_prompt, target_prompt, disentanglement, edit_power, align, mask, progress=gr.Progress(track_tqdm=True)):
+    edit_direction = "_".join(["styleclip_global", neutral_prompt, target_prompt, str(disentanglement)])
+    return edit_image(orig_image, edit_direction, edit_power, align, mask, progress=None)
+
+
+def get_mask(input_image, align, mask_trashhold, progress=gr.Progress(track_tqdm=True)):
+    if not input_image:
+        return gr.update(visible=False), gr.update(value="Need to upload an input image ❗", visible=True)
+
+    input_image_bytes = get_bytes(input_image)
+
+    with grpc.insecure_channel(os.environ['SERVER']) as channel:
+        stub = SFEServiceStub(channel)
+
+        output: SFEResponseMask = stub.generate_mask(
+            SFERequestMask(orig_image=input_image_bytes, trashold=mask_trashhold, align=align, use_cache=True)
+        )
+    if output.mask == b"aligner error":
+        return gr.update(visible=False), gr.update(value="Face aligner can not find face in your image 😢 Try to upload another one", visible=True)
+
+    if output.mask == b"masker face parser error":
+        return gr.update(visible=False), gr.update(value="Masker's face detector can't find face in your image 😢 Try to upload another one", visible=True)
+
+    output_mask = bytes_to_image(output.mask)
+    return gr.update(value=output_mask, visible=True), gr.update(visible=False)
+
+
+def get_demo():
+    editings_table = pd.read_csv("editings_table.csv")
+    editings_table = editings_table.style.set_properties(**{'text-align': 'center'})
+    editings_table = editings_table.set_table_styles([dict(selector='th', props=[('text-align', 'center')])])
+
+    with gr.Blocks() as demo:
+        gr.Markdown("## StyleFeatureEditor")
+        gr.Markdown(
+            '<div style="display: flex; align-items: center; gap: 10px;">'
+            '<span>Official Gradio demo for StyleFeatureEditor:</span>'
+            '<a href="https://arxiv.org/abs/2406.10601"><img src="https://img.shields.io/badge/arXiv-2404.01094-b31b1b.svg" height=22.5></a>'
+            '<a href="https://github.com/AIRI-Institute/StyleFeatureEditor"><img src="https://img.shields.io/badge/github-%23121011.svg?style=for-the-badge&logo=github&logoColor=white" height=22.5></a>'
+            '<a href="https://huggingface.co/AIRI-Institute/StyleFeatureEditor"><img src="https://huggingface.co/datasets/huggingface/badges/resolve/main/model-on-hf-md.svg" height=22.5></a>'
+            '<a href="https://colab.research.google.com/#fileId=https://github.com/AIRI-Institute/StyleFeatureEditor/blob/main/notebook/StyleFeatureEditor_inference.ipynb"><img src="https://colab.research.google.com/assets/colab-badge.svg" height=22.5></a>'
+            '</div>'
+        )
+        with gr.Row():
+            with gr.Column():
+                with gr.Accordion("Input Image", open=True):
+                    input_image = gr.Image(label="Input image you want to edit", type="pil", height=300)
+                    align = gr.Checkbox(label="Align (crop and resize) the input image. For SFE to work well, it is necessary to align the input if it is not.", value=True)
+                with gr.Accordion("Predefined Editings", open=True):
+                    with gr.Accordion("Description", open=False):
+                        gr.Markdown('''A branch of predefined editings gained from InterfaceGAN, Stylespace, GANSpace and StyleClip mappers. Look at the table below to see which direction is responsible for which editings, and which edit power to use.
+
+                        **Editing power** -- the greater the absolute value of this parameter, the more the selected edit will appear.
+
+                        **Editing effect** -- the effect applied to the image when positive editing power is used. If negative power is used, the effect is reversed. 
+
+                        **Editing range** -- the approximate range of editing powers over which editing works well. We have found this empirically, so it may vary from image to image. Using powers outside the range may cause artefacts.
+
+                            '''
+                        )
+
+                        gr.Dataframe(value=editings_table, datatype=["markdown","markdown","markdown","markdown"], interactive=False, wrap=True, 
+                                     column_widths=["25px", "30px", "15px", "30px"], height=300)
+                    with gr.Row():
+                        predef_editing_direction = gr.Dropdown(PREDEFINED_EDITINGS_LIST, label="Editing direction", value="smile")
+                        predef_editing_power = gr.Number(value=7, label="Editing power")
+                    btn_predef = gr.Button("Edit image")
+
+                with gr.Accordion("Text Prompt (StyleClip) Editings", open=False):
+                    with gr.Accordion("Description", open=False):
+                        gr.Markdown('''You can alse use editings from text prompts via **StyleClip Global Mapper** (https://arxiv.org/abs/2103.17249). You just need to choose:
+
+                        **Editing power** -- the greater the absolute value of this parameter, the more the selected edit will appear.
+
+                        **Neutral prompt** -- some neutral description of the original image (e.g. "a face").
+                        
+                        **Target prompt** -- text that contains the desired edit (e.g. "a smilling face").
+
+                        **Disentanglement** -- positive number, the less this attribute -- the more related attributes will also be changed (e.g. for grey hair editing, wrinkle, skin colour and glasses may also be edited)
+                          ''')
+
+                    neutral_prompt = gr.Textbox(value="face with hair", label="Neutreal prompt (e.g. 'a face')")
+                    target_prompt = gr.Textbox(value="face with fire hair", label="Target prompt (e.g. 'a smilling face')")
+                    styleclip_editing_power = gr.Slider(-50, 50, value=10, step=1, label="Editing power")
+                    disentanglement = gr.Slider(0, 1, value=0.1, step=0.01, label="Disentanglement")
+                    btn_clip = gr.Button("Edit image")
+
+                with gr.Accordion("Mask settings (optional)", open=False):
+                    gr.Markdown('''If some artefacts appear during editing (or some details disappear), you can specify an image mask to select which regions of the image should not be edited. The mask must have a size of 1024 x 1024 and represent an inversion of the original image. 
+
+                        '''
+                    )
+                    mask = gr.Image(label="Upload mask for editing", type="pil", height=350)
+                    with gr.Accordion("Mask generating", open=False):
+                        gr.Markdown("Here you can generate mask that separates face (with hair) from the background.")
+                        with gr.Row():
+                            input_mask = gr.Image(label="Input image for mask generating", type="pil", height=240)
+                            output_mask = gr.Image(label="Generated mask", height=240)
+                            error_message_mask = gr.Textbox(label="⚠️ Error ⚠️", visible=False, elem_classes="error-message")
+                        align_mask = gr.Checkbox(label="To align (crop and resize image) or not. Only uncheck this box if the original image has already been aligned.", value=True)
+                        mask_trashhold = gr.Slider(0, 1, value=0.9, step=0.001, label="Mask trashold",
+                                              info="The more this parameter, the more is face part, and the less is background part.")
+                        btn_mask = gr.Button("Generate mask")
+
+            with gr.Column():
+                with gr.Row():
+                    output_inv = gr.Image(label="Inversion result", visible=True)
+                    output_edit = gr.Image(label="Editing result", visible=True)
+                error_message = gr.Textbox(label="⚠️ Error ⚠️", visible=False, elem_classes="error-message")
+                gr.Examples(
+                    label="Input Examples",
+                    examples=[
+                    ["images/scarlet.jpg", "images/scarlet.jpg"], 
+                    ["images/gosling.jpg", "images/gosling.jpg"],
+                    ["images/robert.png", "images/robert.png"],
+                    ["images/smith.jpg", "images/smith.jpg"],
+                    ["images/watson.jpeg", "images/watson.jpeg"],
+                    ], 
+                    inputs=[input_image, input_mask]        
+                )
+
+
+        btn_predef.click(
+            fn=edit_image, 
+            inputs=[input_image, predef_editing_direction, predef_editing_power, align, mask],
+            outputs=[output_edit, output_inv, error_message]
+        )
+        btn_clip.click(
+            fn=edit_image_clip, 
+            inputs=[input_image, neutral_prompt, target_prompt, disentanglement, styleclip_editing_power, align, mask],
+            outputs=[output_edit, output_inv, error_message]
+        )
+        btn_mask.click(
+            fn=get_mask, 
+            inputs=[input_mask, align_mask, mask_trashhold],
+            outputs=[output_mask, error_message_mask]
+        )
+
+        gr.Markdown('''To cite the paper by the authors
+        ```
+        @InProceedings{Bobkov_2024_CVPR,
+            author    = {Bobkov, Denis and Titov, Vadim and Alanov, Aibek and Vetrov, Dmitry},
+            title     = {The Devil is in the Details: StyleFeatureEditor for Detail-Rich StyleGAN Inversion and High Quality Image Editing},
+            booktitle = {Proceedings of the IEEE/CVF Conference on Computer Vision and Pattern Recognition (CVPR)},
+            month     = {June},
+            year      = {2024},
+            pages     = {9337-9346}
+        }
+        ```
+        ''')
+    return demo
+
+
+if __name__ == '__main__':
+    demo = get_demo()
+    demo.launch(server_name="0.0.0.0", server_port=7860)

editings_table.csv

@@ -0,0 +1,36 @@
+Editing name,Editing effect,Editing range,Additional comments
+glasses,add glasses,[-20; 30],may open mouth
+smile,add smile,[-10; 10],
+makeup,add make-up,[-10; 15],bad works with men
+eye_openness,close  eyes,[-30; 45],
+trimmed_beard,remove beard,[-30; 30],bad works with women
+lipstick,add lipstick,[-30; 30],bad works with men
+face_roundness,make face rounder,[-20; 15],
+nose_length,decreace nose length,[-30; 30],may open mouth
+eyebrow_thickness,decreace eyebrow thickness,[-20; 20],
+displeased,add sadness,[-10; 10],
+age,increase age,[-10; 10],
+rotation,turn  face right,[-7 ; 7 ],
+afro,afro hairstyle,[0; 0.14],
+angry,make  angrier,[0; 0.14],cause background artefacts
+bobcut,bobcut hairstyle,[0; 0.18],cause background artefacts
+bowlcut,bowlcut hairstyle,[0; 0.14],cause background artefacts
+mohawk,mohawk hairstyle,[0; 0.10],cause background artefacts
+curly_hair,add curls,[0; 0.12],
+purple_hair,dye hair purple,[0; 0.12],
+surprised,make  more surprised,[0; 0.10],
+beyonce,make similar to beyonce,[0; 0.12],
+hilary_clinton,make similar to hilary clinton,[0; 0.10],
+depp,make similar to johnny depp,[0; 0.12],
+taylor_swift,make similar to taylor swift,[0; 0.10],
+trump,make similar to donald trump,[0; 0.10],
+zuckerberg,make similar to mark zuckerberg,[0; 0.10],
+black hair,darken  hair,[-7; 10],
+blond hair,darken  hair,[-10; 7],"yes, positive power darkens hair, negative lightens hair"
+grey hair,make hair colored,[-7 ; 7],negative means make hair grey
+wavy hair,add hair length,[-7 ; 7],
+receding hairline,remove bald,[-10; 10],
+sideburns,remove sideburns,[-7 ; 7],bad works with women
+goatee,remove goatee,[-7 ; 7],bad works with women
+earrings,add earrings,[0 ; 15],bad works with men
+gender,add femininity,[-10; 7],better use global mapper

inference_pb2.py

@@ -0,0 +1,34 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: inference.proto
+# Protobuf Python Version: 5.26.1
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x0finference.proto\x12\tinference\"r\n\nSFERequest\x12\x12\n\norig_image\x18\x01 \x01(\x0c\x12\x11\n\tdirection\x18\x02 \x01(\t\x12\r\n\x05power\x18\x03 \x01(\x02\x12\x11\n\tuse_cache\x18\x04 \x01(\x08\x12\r\n\x05\x61lign\x18\x05 \x01(\x08\x12\x0c\n\x04mask\x18\x06 \x01(\x0c\"X\n\x0eSFERequestMask\x12\x12\n\norig_image\x18\x01 \x01(\x0c\x12\x10\n\x08trashold\x18\x02 \x01(\x02\x12\x11\n\tuse_cache\x18\x03 \x01(\x08\x12\r\n\x05\x61lign\x18\x04 \x01(\x08\"/\n\x0bSFEResponse\x12\r\n\x05image\x18\x01 \x01(\x0c\x12\x11\n\tinv_image\x18\x02 \x01(\x0c\"\x1f\n\x0fSFEResponseMask\x12\x0c\n\x04mask\x18\x01 \x01(\x0c\x32\x8b\x01\n\nSFEService\x12\x35\n\x04\x65\x64it\x12\x15.inference.SFERequest\x1a\x16.inference.SFEResponse\x12\x46\n\rgenerate_mask\x12\x19.inference.SFERequestMask\x1a\x1a.inference.SFEResponseMaskb\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'inference_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  DESCRIPTOR._loaded_options = None
+  _globals['_SFEREQUEST']._serialized_start=30
+  _globals['_SFEREQUEST']._serialized_end=144
+  _globals['_SFEREQUESTMASK']._serialized_start=146
+  _globals['_SFEREQUESTMASK']._serialized_end=234
+  _globals['_SFERESPONSE']._serialized_start=236
+  _globals['_SFERESPONSE']._serialized_end=283
+  _globals['_SFERESPONSEMASK']._serialized_start=285
+  _globals['_SFERESPONSEMASK']._serialized_end=316
+  _globals['_SFESERVICE']._serialized_start=319
+  _globals['_SFESERVICE']._serialized_end=458
+# @@protoc_insertion_point(module_scope)

inference_pb2_grpc.py

@@ -0,0 +1,145 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+"""Client and server classes corresponding to protobuf-defined services."""
+import grpc
+import warnings
+
+import inference_pb2 as inference__pb2
+
+GRPC_GENERATED_VERSION = '1.64.1'
+GRPC_VERSION = grpc.__version__
+EXPECTED_ERROR_RELEASE = '1.65.0'
+SCHEDULED_RELEASE_DATE = 'June 25, 2024'
+_version_not_supported = False
+
+try:
+    from grpc._utilities import first_version_is_lower
+    _version_not_supported = first_version_is_lower(GRPC_VERSION, GRPC_GENERATED_VERSION)
+except ImportError:
+    _version_not_supported = True
+
+if _version_not_supported:
+    warnings.warn(
+        f'The grpc package installed is at version {GRPC_VERSION},'
+        + f' but the generated code in inference_pb2_grpc.py depends on'
+        + f' grpcio>={GRPC_GENERATED_VERSION}.'
+        + f' Please upgrade your grpc module to grpcio>={GRPC_GENERATED_VERSION}'
+        + f' or downgrade your generated code using grpcio-tools<={GRPC_VERSION}.'
+        + f' This warning will become an error in {EXPECTED_ERROR_RELEASE},'
+        + f' scheduled for release on {SCHEDULED_RELEASE_DATE}.',
+        RuntimeWarning
+    )
+
+
+class SFEServiceStub(object):
+    """Missing associated documentation comment in .proto file."""
+
+    def __init__(self, channel):
+        """Constructor.
+
+        Args:
+            channel: A grpc.Channel.
+        """
+        self.edit = channel.unary_unary(
+                '/inference.SFEService/edit',
+                request_serializer=inference__pb2.SFERequest.SerializeToString,
+                response_deserializer=inference__pb2.SFEResponse.FromString,
+                _registered_method=True)
+        self.generate_mask = channel.unary_unary(
+                '/inference.SFEService/generate_mask',
+                request_serializer=inference__pb2.SFERequestMask.SerializeToString,
+                response_deserializer=inference__pb2.SFEResponseMask.FromString,
+                _registered_method=True)
+
+
+class SFEServiceServicer(object):
+    """Missing associated documentation comment in .proto file."""
+
+    def edit(self, request, context):
+        """Missing associated documentation comment in .proto file."""
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
+    def generate_mask(self, request, context):
+        """Missing associated documentation comment in .proto file."""
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
+
+def add_SFEServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+            'edit': grpc.unary_unary_rpc_method_handler(
+                    servicer.edit,
+                    request_deserializer=inference__pb2.SFERequest.FromString,
+                    response_serializer=inference__pb2.SFEResponse.SerializeToString,
+            ),
+            'generate_mask': grpc.unary_unary_rpc_method_handler(
+                    servicer.generate_mask,
+                    request_deserializer=inference__pb2.SFERequestMask.FromString,
+                    response_serializer=inference__pb2.SFEResponseMask.SerializeToString,
+            ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+            'inference.SFEService', rpc_method_handlers)
+    server.add_generic_rpc_handlers((generic_handler,))
+    server.add_registered_method_handlers('inference.SFEService', rpc_method_handlers)
+
+
+ # This class is part of an EXPERIMENTAL API.
+class SFEService(object):
+    """Missing associated documentation comment in .proto file."""
+
+    @staticmethod
+    def edit(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            '/inference.SFEService/edit',
+            inference__pb2.SFERequest.SerializeToString,
+            inference__pb2.SFEResponse.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True)
+
+    @staticmethod
+    def generate_mask(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            '/inference.SFEService/generate_mask',
+            inference__pb2.SFERequestMask.SerializeToString,
+            inference__pb2.SFEResponseMask.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True)

requirements.txt

@@ -0,0 +1,7 @@
+pillow==10.3.0
+pandas==2.2.2
+gradio==4.37.1
+grpcio==1.63.0
+grpcio_tools==1.63.0
+addict==2.4.0
+gdown==3.12.2