pose-depot
<br/> <p align="center"> <a href="https://a-lgil.github.io/pose-depot/gallery/" target="_blank"> <img width="100%" src="assets/logo/ezgif-3-a558e401d3.gif" alt="Pose Depot logo" style="border-radius: 0.6rem"> </a> </p> <p align="center"> A collection of ControlNet poses. </p> <p align="center"> <a target="_blank" href="LICENSE"><img src="https://img.shields.io/github/license/a-lgil/pose-depot.svg"/></a> <a target="_blank" href="https://github.com/a-lgil/pose-depot/actions"><img src="https://img.shields.io/github/actions/workflow/status/a-lgil/pose-depot/deploy.yml"/></a> <a target="_blank" href="https://github.com/a-lgil/pose-depot/commits"><img src="https://img.shields.io/github/commit-activity/y/a-lgil/pose-depot.svg?color=teal"/></a> <a target="_blank" href="https://civitai.com/user/Pose_Depot"><img src="https://img.shields.io/badge/Civitai-Top 3 Poses Creators (08/2024)-blue.svg?logo=data:image/svg%2bxml;base64,PHN2ZyB2ZXJzaW9uPSIxLjAiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyIgd2lkdGg9IjI1MC4wMDAwMDBwdCIgaGVpZ2h0PSIyNTAuMDAwMDAwcHQiIHZpZXdCb3g9IjAgMCAyNTAuMDAwMDAwIDI1MC4wMDAwMDAiIHByZXNlcnZlQXNwZWN0UmF0aW89InhNaWRZTWlkIG1lZXQiPgo8bWV0YWRhdGEgZmlsbD0iI2ZmZmZmZiI+CkNyZWF0ZWQgYnkgcG90cmFjZSAxLjE2LCB3cml0dGVuIGJ5IFBldGVyIFNlbGluZ2VyIDIwMDEtMjAxOQo8L21ldGFkYXRhPgo8ZyB0cmFuc2Zvcm09InRyYW5zbGF0ZSgwLjAwMDAwMCwyNTAuMDAwMDAwKSBzY2FsZSgwLjEwMDAwMCwtMC4xMDAwMDApIiBmaWxsPSIjZmZmZmZmIiBzdHJva2U9Im5vbmUiPgo8cGF0aCBkPSJNMTE0MCAyNDIzIGMtNTIgLTMxIC0xNDIgLTg0IC0yMDAgLTExOCAtNTggLTM0IC0xMjUgLTczIC0xNTAgLTg3IC01MSAtMjkgLTQ2NCAtMjY3IC01NTMgLTMxOSBsLTU3IC0zMyAwIC02MjIgMCAtNjIyIDEwNyAtNjMgYzYwIC0zNCAyNDEgLTEzOCA0MDMgLTIzMSAxNjIgLTkzIDI5OSAtMTczIDMwNSAtMTc3IDUgLTUgMzUgLTIyIDY1IC0zOCAzMCAtMTcgODMgLTQ3IDExNyAtNjcgMzQgLTIwIDY5IC0zNiA3NyAtMzYgMTUgMCAyMjcgMTE5IDc0NiA0MjAgMTA3IDYyIDIyNCAxMjkgMjYwIDE0OSBsNjUgMzYgMyA2MjUgMiA2MjUgLTIyIDE0IGMtMzUgMjIgLTI1NSAxNTAgLTMxOCAxODQgLTMwIDE2IC01OSAzMyAtNjUgMzggLTEwIDcgLTQwNSAyMzYgLTUwNSAyOTIgLTMwIDE3IC03NSA0MyAtOTkgNTkgLTI1IDE1IC01NCAyOCAtNjUgMjcgLTEyIDAgLTY0IC0yNiAtMTE2IC01NnogbTI5NSAtNzM4IGM5NCAtNTQgMTk2IC0xMTMgMjI4IC0xMzIgbDU3IC0zNCAwIC03NSAwIC03NCAtMTI2IDAgLTEyNyAwIC0xMDUgNjAgYy01OCAzMyAtMTA4IDU5IC0xMTIgNTggLTMgLTIgLTUwIC0yOCAtMTAzIC01OCBsLTk3IC01NSAwIC0xMjIgMCAtMTIxIDc4IC00NSBjMTM0IC03OSAxMTcgLTc4IDIzMCAtMTMgbDEwMCA1NiAxMzEgMCAxMzEgMCAwIC03NCAwIC03MyAtMjMwIC0xMzIgYy0xMjYgLTcyIC0yMzIgLTEzMSAtMjM1IC0xMzEgLTMgMCAtMTA5IDYwIC0yMzUgMTMyIGwtMjMwIDEzMyAyIDI2OSAzIDI2OCAyMzAgMTMzIGMxMjcgNzMgMjMyIDEzMiAyMzUgMTMwIDMgLTEgODIgLTQ2IDE3NSAtMTAweiIgZmlsbD0iI2ZmZmZmZiIvPgo8L2c+Cjwvc3ZnPg=="/></a> </p> <p align="center"> <a href="https://civitai.com/user/Pose_Depot" title="Civitai Bronze New Creators Badge - Awarded for being in the top 100 of the new creators leaderboard"><img src="assets/images/civitai_bronze_new_creators_badge.png" width="50" alt="Bronze New Creators Badge" role="img"/></a> <a href="https://civitai.com/user/Pose_Depot" title="Civitai Bronze Poses Badge - Awarded for being in the top 100 of the Poses leaderboard"><img src="assets/images/civitai_bronze_poses_badge.png" width="50" alt="Bronze Poses Badge" role="img"/></a> <a href="https://civitai.com/user/Pose_Depot" title="Civitai Silver Poses Badge - Awarded for being in the top 10 of the Poses leaderboard"><img src="assets/images/civitai_silver_poses_badge.png" width="50" alt="Gold Poses Badge" role="img"/></a> <a href="https://civitai.com/user/Pose_Depot" title="Civitai Gold Poses Badge - Awarded for being in the top 3 of the Poses leaderboard"><img src="assets/images/civitai_gold_poses_badge.png" width="50" alt="Silver Poses Badge" role="img"/></a> </p> ## Pose Depot is a project that aims to build a high quality collection of images depicting a variety of poses, each provided from different angles with their corresponding depth, canny, normal and OpenPose versions. The aim is to provide a comprehensive dataset designed for use with ControlNets in text-to-image diffusion models, such as Stable Diffusion, providing an additional layer of control to the image generation process. The pose collections can be downloaded directly from [Releases](https://github.com/a-lgil/pose-depot/releases), but with ease of exploration in mind, I've created a [webpage](https://a-lgil.github.io/pose-depot/gallery/) that allows users to conveniently browse, filter by tags, and view the different collections and their content. Bear in mind that the webpage is still a WIP. You can access it by clicking on the image below: <br/> <p align="center"> <a target="_blank" href="https://a-lgil.github.io/pose-depot/gallery/"><img width="100%" src="assets/images/gallery.png" alt="Gallery" style="border-radius: 0.6rem;"> </p> <br/> > \[!IMPORTANT] > > **Star the repository** if you want to receive all release notifications from GitHub without any delay. It also helps motivate me to keep updating the project. \~ ⭐️ ## 🤝 Missing a specific pose? Found a bug? Have a question? Feel free to [**file a new issue**](https://github.com/a-lgil/pose-depot/issues/new/choose) specifying the type of request/issue you're experiencing. We'll be happy to help you out! When asking for a specific pose, please make sure that it complies with the GitHub Community Guidelines and Terms of Service. For private inquiries, you can reach out to me via the email address provided in my GitHub profile. If you already found a solution to your problem or want to contribute with your own poses, we would love to review your pull request! ## 🚀 Usage After downloading a pose collection, you will find multiple variants of the same pose, each with a different style applied to it. Here's a brief explanation of each style: - **OpenPose**: The pose is displayed as an [OpenPose](https://github.com/CMU-Perceptual-Computing-Lab/openpose) skeleton, with its corresponding keypoints highlighted. It can be used to replicate the pose without copying other details like outfits, hairstyles, and backgrounds, leaving room for the model to generate its own details. | OpenPose | OpenPoseHand | OpenPoseFull | |---|---|---| | <img src="collections/4F_Rawr/OpenPose.png" width="200"/> | <img src="collections/4F_Rawr/OpenPoseHand.png" width="200"/> | <img src="collections/4F_Rawr/OpenPoseFull.png" width="200"/> | - **Canny**: The pose is displayed in black and white, with the edges of the pose highlighted. It can be used to condition the outline/silhouette of the pose in the generated image, retaining the pose's structure while allowing the model to generate the details. | Canny | CannyHand | |---|---| | <img src="collections/4F_Rawr/Canny.png" width="200"/> | <img src="collections/4F_Rawr/CannyHand.png" width="200"/> | - **Depth**: The pose is displayed as a depth map in grayscale, allowing the model to understand what parts of the pose are closer or farther away, providing a sense of perspective and distance in the generated image. | Depth | DepthHand | |---|---| | <img src="collections/4F_Rawr/Depth.png" width="200"/> | <img src="collections/4F_Rawr/DepthHand.png" width="200"/> | - **Normal**: The pose is displayed as a normal map with the pose's surface normals represented in RGB colors, providing information about the pose's orientation and lighting. It can be used to help the model generate realistic lighting effects and shadows. | NormalHand | |---| | <img src="collections/4F_Rawr/NormalHand.png" width="200"/> | Depending on your use case or your preferences, you can choose to use one or more of these styles together to condition the generated image. In my case I tend to start with Depth and Canny, and then add OpenPose and Normal if needed. | Example Result | |---| | <img src="collections/4F_Rawr/Example.png" width="200"/> | If you are a beginner and don't know where to start, I recommend checking out [Stable Diffusion web UI](https://github.com/AUTOMATIC1111/stable-diffusion-webui) and its [ControlNet extension](https://github.com/Mikubill/sd-webui-controlnet) to understand how to use these poses in text-to-image diffusion models. You can use [Stability Matrix](https://github.com/LykosAI/StabilityMatrix) to streamline the installation process. > \[!TIP] > > You can use the generation parameters from the example image included in every pose collection as reference. ## 💻 Software & Tools This project was developed using the following software and tools: - [Affinity Photo](https://affinity.serif.com/designer/) - [Affinity Designer](https://affinity.serif.com/photo/) - KKS Chara Studio - [ControlNet material generator for KKS](https://koikatsumodshop.booth.pm/items/5909983) by ai.hogefuge - [Space Grotesk Font](https://floriankarsten.github.io/space-grotesk/) by [Florian Karsten](https://floriankarsten.com/) - [Brutal Astro Theme](https://github.com/ElianCodes/brutal) by [ElianCodes](https://github.com/ElianCodes) - [Stability Matrix](https://github.com/LykosAI/StabilityMatrix) - [Stable Diffusion web UI](https://github.com/AUTOMATIC1111/stable-diffusion-webui) ## 🎨 Disclaimer: About Moral and Ethical Implications I am firmly against art theft, however I believe that text-to-image diffusion models are amazing tools that when used responsibly and ethically, while unable to replace human creativity, can be a great way to democratize art and design, enabling even non-artists like me to prototype, iterate over designs, and create what I can envision in my mind but cannot draw. So, feel free to do whatever you want with these poses. There's no such thing such as more or less "pure" art. Just respect artists and don't go around stealing their art styles. ## 📘 License Pose Depot is released under the under terms of the [Apache License 2.0](LICENSE).