{"id":44134374,"url":"https://github.com/JudgementH/RefAny3D","last_synced_at":"2026-02-20T22:00:57.131Z","repository":{"id":335317141,"uuid":"1143388196","full_name":"JudgementH/RefAny3D","owner":"JudgementH","description":null,"archived":false,"fork":false,"pushed_at":"2026-01-29T15:30:54.000Z","size":22676,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-01-30T04:32:22.557Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/JudgementH.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-27T14:19:35.000Z","updated_at":"2026-01-30T03:15:32.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/JudgementH/RefAny3D","commit_stats":null,"previous_names":["judgementh/refany3d"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/JudgementH/RefAny3D","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JudgementH%2FRefAny3D","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JudgementH%2FRefAny3D/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JudgementH%2FRefAny3D/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JudgementH%2FRefAny3D/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JudgementH","download_url":"https://codeload.github.com/JudgementH/RefAny3D/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JudgementH%2FRefAny3D/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29666419,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-20T19:49:36.704Z","status":"ssl_error","status_checked_at":"2026-02-20T19:44:05.372Z","response_time":59,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":[],"created_at":"2026-02-08T23:00:22.908Z","updated_at":"2026-02-20T22:00:57.126Z","avatar_url":"https://github.com/JudgementH.png","language":"Python","funding_links":[],"categories":["3D-assets"],"sub_categories":[],"readme":"# RefAny3D: 3D Asset-Referenced Diffusion Models for Image Generation\n\n\u003ca href='https://arxiv.org/abs/2601.22094'\u003e\u003cimg src='https://img.shields.io/badge/arXiv-2601.22094-b31b1b.svg'\u003e\u003c/a\u003e \u0026nbsp;\n\u003ca href='https://judgementh.github.io/RefAny3D'\u003e\u003cimg src='https://img.shields.io/badge/Project-Page-Green'\u003e\u003c/a\u003e \u0026nbsp;\n\u003ca href=\"https://huggingface.co/JudgementH/RefAny3D\"\u003e\u003cimg src=\"https://img.shields.io/badge/🤗_HuggingFace-Model-ffbd45.svg\" alt=\"HuggingFace\"\u003e\u003c/a\u003e\n\u003ca href=\"https://huggingface.co/datasets/JudgementH/RefAny3D-Dataset\"\u003e\u003cimg src=\"https://img.shields.io/badge/🤗_HuggingFace-Dataset-ffbd45.svg\" alt=\"HuggingFace\"\u003e\u003c/a\u003e\n\n![teaser](assets/teaser.png)\n\n## TODO List\n- [x] Inference code and pretrained models.\n- [x] Training code.\n- [x] Training dataset.\n\n## Quickstart\n\n### Create environment\n1. Clone the repository and create a conda environment: \n```\ngit clone https://github.com/JudgementH/RefAny3D.git\nconda create -n r3d python=3.10\nconda activate r3d\n```\n2. Install requirements\n```\npip install -r requirements.txt\n```\n\n\n### Inference\n```\npython demo.py \\\n    --prompt \"\u003ctext-prompt\u003e\" \\\n    --glb_path \"\u003cglb-file-path\u003e\" \\\n    --output_dir \"\u003coutput-dir\u003e\"\n\n```\n\nAlternatively, we provide some example scripts:\n\n```\nbash scripts/demo_chair.sh\n\nbash scripts/demo_traffic_cone.sh\n```\n\n## Training\n\n### Download Dataset\n\nFirst, download the training [dataset](https://huggingface.co/datasets/JudgementH/RefAny3D-Dataset) and organize it in the appropriate directory structure.\n\n### Configure Training\n\n1. Edit the training configuration file `train/config/train_refany3d.yaml`:\n   - Update `json_file` path under `train.dataset` section (default: `\"./dataset/meta_data.json\"`)\n   - Update `data_root_path` path under `train.dataset` section (default: `\"./dataset\"`)\n\n   Example configuration:\n   ```yaml\n   train:\n     dataset:\n       json_file: \"\u003cpath-to-your-meta-data.json\u003e\"\n       data_root_path: \"\u003cpath-to-your-dataset-root\u003e\"\n   ```\n\n### Run Training\n\nExecute the training script:\n\n```\nbash train/scripts/train_refany3d.sh\n```\n\n**Note:** The training script uses `accelerate` with 8 GPU processes by default. You can modify the number of processes in `train/scripts/train_refany3d.sh` by adjusting the `--num_processes` parameter.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FJudgementH%2FRefAny3D","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FJudgementH%2FRefAny3D","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FJudgementH%2FRefAny3D/lists"}