{"id":24353941,"url":"https://github.com/cgund98/cloud-render","last_synced_at":"2025-04-15T11:55:21.825Z","repository":{"id":43492518,"uuid":"462034458","full_name":"cgund98/cloud-render","owner":"cgund98","description":"A blender add-on for creating your own private render farm on AWS.","archived":false,"fork":false,"pushed_at":"2023-07-27T14:33:34.000Z","size":134,"stargazers_count":5,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-15T11:55:14.904Z","etag":null,"topics":["3d","aws","blender","rendering"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cgund98.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-02-21T21:16:48.000Z","updated_at":"2024-06-04T20:03:42.000Z","dependencies_parsed_at":"2025-01-18T16:36:51.652Z","dependency_job_id":"2b468977-1620-4fca-8af7-436304d676ac","html_url":"https://github.com/cgund98/cloud-render","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cgund98%2Fcloud-render","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cgund98%2Fcloud-render/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cgund98%2Fcloud-render/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cgund98%2Fcloud-render/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cgund98","download_url":"https://codeload.github.com/cgund98/cloud-render/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249067775,"owners_count":21207395,"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":["3d","aws","blender","rendering"],"created_at":"2025-01-18T16:34:07.428Z","updated_at":"2025-04-15T11:55:21.795Z","avatar_url":"https://github.com/cgund98.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Lint and Build](https://github.com/cgund98/cloud-render/actions/workflows/build.yaml/badge.svg)](https://github.com/cgund98/cloud-render/actions/workflows/build.yaml)\n# Cloud Render\n\n\u003e An artist-friendly blender add-on for creating your own private render farm on AWS.\n\n![Python](https://img.shields.io/badge/Python-3776AB?style=for-the-badge\u0026logo=python\u0026logoColor=white)\n![Amazon AWS](https://img.shields.io/badge/Amazon_AWS-232F3E?style=for-the-badge\u0026logo=amazon-aws\u0026logoColor=white)\n\nAre you stuck working on a potato PC? Want to use your workstation for other tasks while you render?\n\nIf any of those problems seem familiar, you may want to try processing your renders on **your own private render farm**!\n\nCloud Render is a **free** add-on for Blender that enables you to quickly deploy a render farm and outsource your rendering workloads in the cloud (AWS).\n\n### Features\n* Render multiple blend files in parallel.\n* Run your workloads on up to **80 CPU cores** at once for extremely cheap (\u003c$1/hr).\n* Entire process requires no coding or technical experience.\n* Full support for compositing workflows with multiple file outputs.\n\n## Getting started\n\n### Installation\nDownload the latest `zip` file of the add-on from the [releases page](https://github.com/cgund98/cloud-render/releases).\n\n1. Install and enable the zip file like any other add-on via `Edit \u003e Preferences \u003e Add-ons`.\n2. Stay on the Add-ons tab in the Preferences window.\n\n    Expand the \"Cloud Render\" add-on and click the `Install dependencies` button if you have not done so before.\n    \n    You may have to run Blender as an administrator the first time you do this.\n3. You should now see a new panel under `Properties \u003e Render Settings \u003e Cloud Render`. You've installed the add-on!\n\n### Authenticating to AWS\nNow that you've installed the add-on, you need to create an AWS account and enter your credentials so the add-on can create your render farm for you.\n\n1. Create an AWS account. If you need help, follow the [official instructions](https://aws.amazon.com/premiumsupport/knowledge-center/create-and-activate-aws-account/).\n2. Create a set of credentials for a service account by following [this guide](./docs/guides/creating-service-account.md).\n3. Under the `Cloud Render \u003e AWS Credentials` enter your desired AWS region, access key ID, and secret access key from the previous step.\n\n    Your region is the geographic data center in which your service will operate. For example, `us-east-2` is a data center in Ohio, USA.\n\n    For picking a region, try to pick one of the larger regions, one of: `us-east-1`, `us-east-2`, `us-west-1`, `us-west-2`, `eu-west-1`, `eu-west-2`, `ap-southeast-1`, `ap-southeast-2`. See a complete list of regions [here](https://awsregion.info/).\n\n### Manage your render farm\nYou should be all set to deploy your private render farm! Managing farms is done through the `Cloud Render \u003e Render Farm` panel.\n\nIf the render farm status is `UNKNOWN`, simply refresh the farm status with the `Refresh` button.\n\nIf the farm's status is `NOT_DEPLOYED`, you can deploy a new farm with the `Deploy` button.\n\nYou can shut down a render farm at any time with the `Shut Down` button.\n\n_Note: you will have only one render farm across all your blend files._\n\n### Create a new job\nCreating a new render job is quite simple inside the `Cloud Render \u003e Jobs \u003e New` panel.\n\nThere is only one option, `Render Animation`. If unchecked, the job will only render the current frame. If checked, it will render the entire animation.\n\nWhen you are ready, click `Create job`. This will do a few things:\n1. Pack all external resources inside your blend file. This is the same as `File \u003e External Data \u003e Pack Resources`.\n2. Save the blend file.\n3. Upload the blend file to the cloud.\n4. For every frame that will be rendered, create a \"batch job\". Your job will render one frame at a time in parallel.\n\nThat's it!\n\n### Manage jobs\nYou can manage all existing jobs across all blend files in the `Cloud Render \u003e Jobs \u003e Manage` panel.\n\nUse the `Refresh` button to refresh the list of jobs as well as the details of the selected job.\n\nAt any time, even when a job is not yet completed, you can pull its output files and save them locally. Do this by selecting an output directory and clicking the `Download Files` button.\n\n*Note: Ensure your renders do not write anywhere outside of the same path as the blend file. All render outputs should be under `//`. Anything outside of this path will not be recognized and downloaded.*\n\nDelete the selected job with the `Delete Job` button. This will remove all job files from the cloud permanently.\n\n## FAQ\n\n### What is AWS?\n[Amazon Web Services (AWS)](https://aws.amazon.com/what-is-aws/) is a leading cloud platform used by companies around the world. Seriously, AWS powers probably half the internet.\n\nFor our purposes, we can just think of them as a \"hosting service\". Instead of buying PCs ourselves and connecting them to the internet, you can simply rent out machines and storage space from AWS.\n\nYou could buy 3 dedicated rendering machines for your office, or you could rent hundreds of servers over the course of a few hours and shut them down when you're finished. You only pay for what you use.\n\n### How much does it cost?\nFor more details on the costs of running render jobs, please see the [pricing guide](./docs/overview/pricing.md).\n\n## Troubleshooting\nIf you run into any problems using the add-on, please create a [new issue](https://github.com/cgund98/cloud-render/issues/new).\n\n### Deleting render farm manually\nIf for whatever reason the add-on is not working or you want to be completely sure you aren't being charged for resources that are currently running, you need to delete the AWS resources manually.\n\nThis is quite easy. Navigate to the \"CloudFormation\" service via the search menu. Make sure you have selected the same region in the top right of the window as you entered in the add-on panel. E.g. if you entered `us-east-2`, you should see \"Ohio\".\n\nIn the \"Stacks\" tab, any resources created by the add-on will have a name starting with `cloud-render-`. If they exist, feel free to delete them. This should remove all resources by Cloud Render.\n\n## Contributing\nHave any ideas for new features or improvements? Feel free to create an [issue](https://github.com/cgund98/cloud-render/issues/new), or simply implement the changes yourself!\n\n1. [Fork it](https://github.com/cgund98/cloud-render/fork)\n2. Create your feature branch (`git checkout -b feature-name`)\n3. Commit your changes (`git commit -am 'Add some feature'`)\n4. Push to the branch (`git push origin feature-name`)\n5. Create a new Pull Request\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcgund98%2Fcloud-render","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcgund98%2Fcloud-render","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcgund98%2Fcloud-render/lists"}