{"id":31908975,"url":"https://github.com/allenai/phone2proc","last_synced_at":"2025-10-13T15:59:59.768Z","repository":{"id":187758585,"uuid":"677466559","full_name":"allenai/phone2proc","owner":"allenai","description":"📱👉🏠 Perform conditional procedural generation to generate houses like your own!","archived":false,"fork":false,"pushed_at":"2023-08-11T21:12:45.000Z","size":86,"stargazers_count":26,"open_issues_count":0,"forks_count":1,"subscribers_count":5,"default_branch":"main","last_synced_at":"2024-04-14T07:50:00.343Z","etag":null,"topics":["ai2-thor","artificial-intelligence","computer-vision","embodied-ai","procthor","robotics"],"latest_commit_sha":null,"homepage":"https://phone2proc.allenai.org/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/allenai.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}},"created_at":"2023-08-11T16:35:46.000Z","updated_at":"2024-03-26T21:48:30.000Z","dependencies_parsed_at":"2023-08-12T03:28:19.310Z","dependency_job_id":null,"html_url":"https://github.com/allenai/phone2proc","commit_stats":null,"previous_names":["allenai/phone2proc"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/allenai/phone2proc","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/allenai%2Fphone2proc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/allenai%2Fphone2proc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/allenai%2Fphone2proc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/allenai%2Fphone2proc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/allenai","download_url":"https://codeload.github.com/allenai/phone2proc/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/allenai%2Fphone2proc/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279015953,"owners_count":26085777,"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","status":"online","status_checked_at":"2025-10-13T02:00:06.723Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["ai2-thor","artificial-intelligence","computer-vision","embodied-ai","procthor","robotics"],"created_at":"2025-10-13T15:59:51.529Z","updated_at":"2025-10-13T15:59:59.762Z","avatar_url":"https://github.com/allenai.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 📱👉🏠 Phone2Proc\n\n![my-file](https://github.com/allenai/phone2proc/assets/28768645/b5dfaec4-3a4b-45bd-bbaf-69fd379faf64)\n\n\nThis repository contains the code for [Phone2Proc](https://arxiv.org/abs/2212.04819). It performs conditional procedural generation to build a dataset of houses based on a specified [RoomPlan USDZ file](https://developer.apple.com/augmented-reality/roomplan/). The backend uses AI2-THOR and ProcTHOR. The generated houses are in the ProcTHOR house JSON format (see [this tutorial](https://colab.research.google.com/drive/1Il6TqmRXOkzYMIEaOU9e4-uTDTIb5Q78) on loading them into ProcTHOR). \n\nTo obtain RoomPlan USDZ files, you'll need to load a custom app onto your phone, scan your scene, and then export it to a USDZ.\n\nSee the [this tutorial](https://www.youtube.com/watch?v=wgqwrgNiA68) and the [RoomPlan tutorial](https://developer.apple.com/documentation/roomplan/create_a_3d_model_of_an_interior_room_by_guiding_the_user_through_an_ar_experience) for more help.\n\nTo build the houses, install the requirements:\n\n```bash\npip install -r requirements.txt\npip install --extra-index-url https://ai2thor-pypi.allenai.org ai2thor==0+391b3fae4d4cc026f1522e5acf60953560235971\n```\n\nThen run:\n\n```bash\npython3 dmain_wrapper.py\n```\n\nIt'll generate houses based on the specified RoomPlan layout. You may need to go into `main.py` and change some constants, such as which USDZ file is being used.\n\nNote that the RoomPlan scene must have all walls form an enclosed loop. Otherwise the generation will not work as it'll be underspecified how to generate the floorplan.\n\n## 📖 Citation\n\nTo cite Phone2Proc, please use the following entry:\n\n```bash\n@inproceedings{phone2proc,\n  title={Phone2proc: Bringing robust robots into our chaotic world},\n  author={Deitke, Matt and Hendrix, Rose and Farhadi, Ali and Ehsani, Kiana and Kembhavi, Aniruddha},\n  booktitle={Proceedings of the IEEE/CVF Conference on Computer Vision and Pattern Recognition},\n  pages={9665--9675},\n  year={2023}\n}\n```\n\n## 👋 Our Team\n\nAI2-THOR is an open-source project built by the [PRIOR team](//prior.allenai.org) at the [Allen Institute for AI](//allenai.org) (AI2).\nAI2 is a non-profit institute with the mission to contribute to humanity through high-impact AI research and engineering.\n\n\u003cbr /\u003e\n\n\u003ca href=\"//prior.allenai.org\"\u003e\n\u003cp align=\"center\"\u003e\u003cimg width=\"100%\" src=\"https://raw.githubusercontent.com/allenai/ai2thor/main/doc/static/ai2-prior.svg\" /\u003e\u003c/p\u003e\n\u003c/a\u003e\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fallenai%2Fphone2proc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fallenai%2Fphone2proc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fallenai%2Fphone2proc/lists"}