{"id":13404229,"url":"https://github.com/carefree0910/carefree-creator","last_synced_at":"2025-05-14T23:04:38.389Z","repository":{"id":59223218,"uuid":"536013043","full_name":"carefree0910/carefree-creator","owner":"carefree0910","description":"AI magics meet Infinite draw board.","archived":false,"fork":false,"pushed_at":"2024-05-09T01:47:27.000Z","size":8453,"stargazers_count":1948,"open_issues_count":23,"forks_count":180,"subscribers_count":72,"default_branch":"dev","last_synced_at":"2025-04-13T20:39:11.609Z","etag":null,"topics":["image-to-image","inpainting","latent-diffusion","outpainting","pypi","python","pytorch","sketch-to-image","stable-diffusion","super-resolution","text-to-image"],"latest_commit_sha":null,"homepage":"https://creator.nolibox.com/guest","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/carefree0910.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2022-09-13T07:40:08.000Z","updated_at":"2025-04-05T19:58:08.000Z","dependencies_parsed_at":"2023-02-10T19:46:15.905Z","dependency_job_id":"b9c4e42a-435f-45a2-b725-29c8db862ae8","html_url":"https://github.com/carefree0910/carefree-creator","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":"carefree0910/carefree-client-template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/carefree0910%2Fcarefree-creator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/carefree0910%2Fcarefree-creator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/carefree0910%2Fcarefree-creator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/carefree0910%2Fcarefree-creator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/carefree0910","download_url":"https://codeload.github.com/carefree0910/carefree-creator/tar.gz/refs/heads/dev","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254243358,"owners_count":22038046,"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":["image-to-image","inpainting","latent-diffusion","outpainting","pypi","python","pytorch","sketch-to-image","stable-diffusion","super-resolution","text-to-image"],"created_at":"2024-07-30T19:01:41.190Z","updated_at":"2025-05-14T23:04:33.369Z","avatar_url":"https://github.com/carefree0910.png","language":"Jupyter Notebook","funding_links":[],"categories":["Jupyter Notebook","👑Stable Diffusion","Training","Image Generation \u0026 Editing"],"sub_categories":["Jupyter Notebook","GUIS"],"readme":"![noli-creator](./static/images/social-image.jpg)\n\nAn open sourced, AI-powered creator for everyone.\n\n\u003e * This is the backend project of the `Creator` product. If you are looking for the **WebUI** codes, you may checkout the [`carefree-drawboard`](https://github.com/carefree0910/carefree-drawboard) 🎨 project.\n\u003e\n\u003e * Most of the contents have been moved to the [Wiki](https://github.com/carefree0910/carefree-creator/wiki) page.\n\n\u003cdiv align=\"center\"\u003e\n\n### [Wiki](https://github.com/carefree0910/carefree-creator/wiki) | [WebUI Codes](https://github.com/carefree0910/carefree-drawboard)\n\n\u003cdiv align=\"left\"\u003e\n\n# Installation\n\n`carefree-creator` is built on top of `carefree-learn`, and requires:\n- `Python\u003e=3.8`\n- `pytorch\u003e=1.12.0`. Please refer to [PyTorch](https://pytorch.org/get-started/locally/)'s official website, and it is highly recommended to pre-install PyTorch with conda.\n\n## Hardware Requirements\n\n\u003e Related issue: [#10](https://github.com/carefree0910/carefree-creator/issues/10).\n\nThis project will eat up 11~13 GB of GPU RAM if no modifications are made, because it actually integrates FIVE different SD versions together, and many other models as well. 🤣\n\nThere are two ways that can reduce the usage of GPU RAM - lazy loading and partial loading, see the following [`Run`](#run) section for more details.\n\n## pip installation\n\n```bash\npip install carefree-creator\n```\n\nIf you are interested in the latest features, you may use `pip` to install from source as well:\n\n```bash\ngit clone https://github.com/carefree0910/carefree-creator.git\ncd carefree-creator\npip install -e .\n```\n\n### Run\n\n`carefree-creator` builds a CLI for you to setup your local service. For instance, we can:\n\n```bash\ncfcreator serve\n```\n\nIf you don't have an NVIDIA GPU (e.g. mac), you may try:\n\n```bash\ncfcreator serve --cpu\n```\n\nIf you are using your GPU-powered laptop, you may try:\n\n```bash\ncfcreator serve --limit 1\n```\n\n\u003e The `--limit` flag is used to limit the number of loading models. By specifying `1`, only the executing model will be loaded, and other models will stay on your disk.\n\u003e\n\u003e See [#10](https://github.com/carefree0910/carefree-creator/issues/10#issuecomment-1520661893) for more details.\n\nIf you have plenty of RAM resources but your GPU RAM is not large enough, you may try:\n\n```bash\ncfcreator serve --lazy\n```\n\n\u003e With the `--lazy` flag, the models will be loaded to RAM, and only the executing model will be moved to GPU RAM.\n\u003e \n\u003e So as an exchange, your RAM will be eaten up! 🤣\n\nIf you only want to try the SD basic endpoints, you may use:\n\n```bash\ncfcreator serve --focus sd.base\n```\n\nAnd if you only want to try the SD anime endpoints, you may use:\n\n```bash\ncfcreator serve --focus sd.anime\n```\n\nMore usages could be found by:\n\n```bash\ncfcreator serve --help\n```\n\n## Docker\n\n### Prepare\n\n```bash\nexport TAG_NAME=cfcreator\ngit clone https://github.com/carefree0910/carefree-creator.git\ncd carefree-creator\n```\n\n### Build\n\n```bash\ndocker build -t $TAG_NAME .\n```\n\nIf your internet environment lands in China, it might be faster to build with `Dockerfile.cn`:\n\n```bash\ndocker build -t $TAG_NAME -f Dockerfile.cn .\n```\n\n### Run\n\n```bash\ndocker run --gpus all --rm -p 8123:8123 $TAG_NAME:latest\n```\n\n# Credits\n\n- [Stable Diffusion](https://github.com/CompVis/stable-diffusion), the foundation of various generation methods.\n- [Stable Diffusion from runwayml](https://github.com/runwayml/stable-diffusion), the adopted SD-inpainting method.\n- [Waifu Diffusion](https://github.com/harubaru/waifu-diffusion), the anime-finetuned version of Stable Diffusion.\n- [Real ESRGAN](https://github.com/xinntao/Real-ESRGAN), the adopted Super Resolution methods.\n- [Latent Diffusion](https://github.com/CompVis/latent-diffusion), the adopted Inpainting \u0026 Landscape Synthesis method.\n- [carefree-learn](https://github.com/carefree0910/carefree-learn), the code base that has re-implemented all the models above and provided clean and handy APIs.\n- And You! Thank you for watching!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcarefree0910%2Fcarefree-creator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcarefree0910%2Fcarefree-creator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcarefree0910%2Fcarefree-creator/lists"}