{"id":18519887,"url":"https://github.com/jbilcke-hf/atryon","last_synced_at":"2025-08-05T09:24:36.975Z","repository":{"id":227873128,"uuid":"770955806","full_name":"jbilcke-hf/atryon","owner":"jbilcke-hf","description":"[WIP] AI Try-On plugin for Chrome","archived":false,"fork":false,"pushed_at":"2024-03-16T14:02:19.000Z","size":143,"stargazers_count":27,"open_issues_count":1,"forks_count":7,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-03-29T19:41:57.368Z","etag":null,"topics":["artificial-intelligence","chrome-plugin","fashion","try-on"],"latest_commit_sha":null,"homepage":"https://www.loom.com/share/6d406e778e2744f997c6b304bf7d3469","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jbilcke-hf.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-03-12T12:43:15.000Z","updated_at":"2025-01-21T11:58:54.000Z","dependencies_parsed_at":"2024-12-25T23:24:41.976Z","dependency_job_id":"78642b84-7052-492d-9755-030c59d8690d","html_url":"https://github.com/jbilcke-hf/atryon","commit_stats":null,"previous_names":["jbilcke-hf/atryon"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jbilcke-hf%2Fatryon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jbilcke-hf%2Fatryon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jbilcke-hf%2Fatryon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jbilcke-hf%2Fatryon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jbilcke-hf","download_url":"https://codeload.github.com/jbilcke-hf/atryon/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250337933,"owners_count":21414102,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["artificial-intelligence","chrome-plugin","fashion","try-on"],"created_at":"2024-11-06T17:17:43.559Z","updated_at":"2025-04-22T22:51:58.176Z","avatar_url":"https://github.com/jbilcke-hf.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Atryon\n\nAtryon (pronounced \"a-try-on\", the name comes from \"AI Try On\") is a free Chrome extension to see yourself wearing the various clothes you see on e-commerce websites.\n\n## Usage recommendations\n\n### Recommendations for the model\n\nThe plugin works by identifying pictures of clothes in the page (the \"garment\" pictures\nand replace them with your own photo (the \"model\" picture).\n\nPlease only use a picture of yourself as model.\n\n### Recommendations for the model model\n\nI recommend to use model pictures adapted to the kind of clothes you want to try.\n\nBy default you should have least have a t-short and trousers.\nBut for instance if you want to try a dress, you should also have a dress picture ready.\n\n### Recommendations for the garment image\n\nCurrently, the model works best with a clean garment image, with no body parts.\nIf your image contains body parts (such as hair), those may appear in the final image.\n\n## Instructions for developers\n\n### run\n\n1. run docker\n\n`docker compose up -d --build`\n\n2. Turn on developer mode in the Chrome [Extension page](chrome://extensions/) and load dist file\n\n#### restart\n\n`docker restart extension`\n\n#### logs\n\n`docker logs extension -f`\n\n#### stop\n\n`docker stop extension`\n\n#### background(service-worker) development\n\nClicking on service worker link in [chrome://extensions/](chrome://extensions/) launches the developer tool\n\n### build\n\n#### Access within docker environment\n\n`docker compose exec extension ash`\n\n#### Run build command\n\n`/usr/src/app # yarn build`\n\n### Deploying the backend\n\n#### Note about billing\n\nRunning the try-on API can be expensive if you do too many requests,\nor leave the server on for too long.\n\nRegardless of the provider, please verify your payment capacity and only spend what you can afford.\n\n#### Deploy to Hugging Face\n\nFirst install [grog](https://github.com/multimodalart/grog), then follow grog's README.md instructions.\n\nTo deploy the backend you will need two servers:\n\n##### Segmentation server\n\nA segmentation server (only necessary whenever you want to add a new picture).\nYou can stop this server from running whenever you are done with preparing your pictures.\n\n```\npython grog.py --replicate_model_id jbilcke/oot_diffusion_with_mask --run_type huggingface_spaces --huggingface_token YOUR_OWN_HUGGINGFACE_TOKEN --space_hardware a10g-small\n```\n\n##### Substitution server\n\nThen you need the actual substitution server, which does the image substitution job.\nBe careful of costs! You are strongly recommended to stop the server once you do not use it anymore.\n\n```\npython grog.py --replicate_model_id viktorfa/oot_segmentation --run_type huggingface_spaces --huggingface_token YOUR_OWN_HUGGINGFACE_TOKEN --space_hardware a10g-small\n```\n\n\n#### Deploy to Replicate\n\nThere is already a Replicate model deployed at [viktorfa/oot_diffusion](https://replicate.com/viktorfa/oot_diffusion). Follow Replicate's instructions if you want your own \"always-on\" server.\n\n\n## Why using Atryon is better than a built-in try on widget that some websites have\n\n### Compatible with all platforms\n\nA lot of e-commerce websites are a bit late when it comes to using AI technologies,\nand only a few are willing to develop or purchase a virtual try-on solution for their websites.\n\nWith Atryon this becomes a non-issue: regardless of the technology used by each shopping website,\nimages will be replaced by a picture of yourself, all automatically.\n\n### Configure once, run everywhere\n\nWith Atryon, you do not need to setup a virtual 3D avatar, send your picture to \neach of the e-commerce website your visit.\n\nInstead you do the setup once, and it \"just works\".\n\n### Privacy first\n\nIt can be a bit nerve wrecking to send your picture to a dozen of shopping platforms,\nyou never know what they will do with it.\n\nWith Atryon, you only need to send your picture to one provider.\nAnd the best thing? You get to choose which one, you can even run it locally if you want!\n\nBy default we provide an access to Hugging Face, which preserves your privacy \n(images are not stored or logged).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjbilcke-hf%2Fatryon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjbilcke-hf%2Fatryon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjbilcke-hf%2Fatryon/lists"}