Instructions to use anonymous-abc123/UniPhysGen-1.7B-Structure with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use anonymous-abc123/UniPhysGen-1.7B-Structure with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("text-generation", model="anonymous-abc123/UniPhysGen-1.7B-Structure") messages = [ {"role": "user", "content": "Who are you?"}, ] pipe(messages)# pip install -U transformers accelerate # Load model directly from transformers import AutoModelForCausalLM model = AutoModelForCausalLM.from_pretrained("anonymous-abc123/UniPhysGen-1.7B-Structure", device_map="auto") - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- vLLM
How to use anonymous-abc123/UniPhysGen-1.7B-Structure with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "anonymous-abc123/UniPhysGen-1.7B-Structure" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "anonymous-abc123/UniPhysGen-1.7B-Structure", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/anonymous-abc123/UniPhysGen-1.7B-Structure
- SGLang
How to use anonymous-abc123/UniPhysGen-1.7B-Structure with SGLang:
Install from pip and serve model
# Install SGLang from pip: pip install sglang # Start the SGLang server: python3 -m sglang.launch_server \ --model-path "anonymous-abc123/UniPhysGen-1.7B-Structure" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "anonymous-abc123/UniPhysGen-1.7B-Structure", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker images
docker run --gpus all \ --shm-size 32g \ -p 30000:30000 \ -v ~/.cache/huggingface:/root/.cache/huggingface \ --env "HF_TOKEN=<secret>" \ --ipc=host \ lmsysorg/sglang:latest \ python3 -m sglang.launch_server \ --model-path "anonymous-abc123/UniPhysGen-1.7B-Structure" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "anonymous-abc123/UniPhysGen-1.7B-Structure", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }' - Docker Model Runner
How to use anonymous-abc123/UniPhysGen-1.7B-Structure with Docker Model Runner:
docker model run hf.co/anonymous-abc123/UniPhysGen-1.7B-Structure
1.7B Articulation Structure Checkpoint
Given a full-object point cloud, a target-part point cloud, and the object's candidate part list, this checkpoint predicts which parts move together with the target part.
Model details
| Item | Value |
|---|---|
| Internal task name | group |
| Required geometry | Object point cloud + target-part point cloud + candidate-part metadata |
| Training lineage | 1.7B initialization โ physical grounding โ structure fine-tuning |
| Training data | To be announced |
| Evaluation data | To be announced |
| Tested Transformers version | 4.51.0 |
Inputs and outputs
The object .npz must contain the regular point-cloud arrays and two additional
candidate-part arrays:
point float32 [N, 3]
color uint8 [N, 3]
normal float32 [N, 3]
part_names [K]
part_centers [K, 3]
part_names contains candidate part identifiers. part_centers contains their
centers in the source coordinate frame and must be aligned with part_names.
The target part must also be supplied as a separate point cloud.
The structured prediction is:
{"members": [0, 2, 3]}
Every returned member is selected from the supplied candidate identifiers.
Installation
Set CODE_REPO_URL to the URL of the anonymous source code repository.
git clone "$CODE_REPO_URL" source
cd source
python -m pip install -e .
bash scripts/install_cuda_extensions.sh
The model uses a custom Transformers architecture. Install the accompanying source code before
loading the checkpoint; a generic transformers.pipeline is not supported.
Inference
Replace /path/to/checkpoint with the local checkpoint directory.
CUDA_VISIBLE_DEVICES=0 python inference_batch_articulation_structure.py \
--model_path /path/to/checkpoint \
--object_pcd examples/object_with_parts.npz \
--part_pcd examples/part.npz \
--output outputs/articulation_structure.json
For batch inference, pass a JSON list with --input_json. The source candidate
metadata is retained in each output record for traceability and evaluation.
Evaluation
python -m eval articulation_structure PREDICTIONS \
--output articulation_structure_metrics.json
Benchmark results are pending.
Intended use and limitations
This checkpoint is intended for research on articulation structure grounding and for proposing motion-coupled part groups in 3D assets. Its result depends on the completeness and correctness of the supplied candidate part decomposition.
Performance may degrade for missing or duplicated parts, inconsistent part identifiers, very fine or very coarse decompositions, nested mechanisms, sparse point clouds, or objects outside the training distribution. Validate the predicted grouping before constructing simulation constraints.
License
The model weights are released under the Creative Commons Attribution-NonCommercial 4.0 International license. Commercial use is not permitted under this license. The accompanying source code is licensed separately under Apache-2.0. See the included license for Qwen3 and Sonata attribution.
- Downloads last month
- -