Instructions to use anonymous-abc123/UniPhysGen-1.7B-Physics with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use anonymous-abc123/UniPhysGen-1.7B-Physics with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("text-generation", model="anonymous-abc123/UniPhysGen-1.7B-Physics") 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-Physics", device_map="auto") - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- vLLM
How to use anonymous-abc123/UniPhysGen-1.7B-Physics 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-Physics" # 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-Physics", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/anonymous-abc123/UniPhysGen-1.7B-Physics
- SGLang
How to use anonymous-abc123/UniPhysGen-1.7B-Physics 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-Physics" \ --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-Physics", "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-Physics" \ --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-Physics", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }' - Docker Model Runner
How to use anonymous-abc123/UniPhysGen-1.7B-Physics with Docker Model Runner:
docker model run hf.co/anonymous-abc123/UniPhysGen-1.7B-Physics
1.7B Part-Level Physics Checkpoint
Given a full-object point cloud and a target-part point cloud, this checkpoint predicts structured part identity, semantic descriptions, and intrinsic physical properties.
Model details
| Item | Value |
|---|---|
| Internal task name | physics |
| Required geometry | Object point cloud + target-part point cloud |
| Training lineage | 1.7B initialization โ physical semantic alignment |
| Training data | To be announced |
| Evaluation data | To be announced |
| Tested Transformers version | 4.51.0 |
Inputs and outputs
The recommended point-cloud format is .npz with aligned arrays:
point float32 [N, 3]
color uint8 [N, 3]
normal float32 [N, 3]
Object and part point clouds are normalized together by the inference pipeline. The structured result contains:
part_identity: part name and motion type;semantic_description: basic, functional, movement, and grasp descriptions;physical_properties: material, density, Young's modulus, hardness, Poisson's ratio, friction, graspability, and affordance.
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_intrinsic_physics_part.py \
--model_path /path/to/checkpoint \
--object_pcd examples/object.npz \
--part_pcd examples/part.npz \
--output outputs/intrinsic_physics_part.json
The entry point also accepts a JSON list through --input_json. See the main
project README for the batch schema, path resolution rules, and output record
format. The final prediction is stored in result, while raw_response keeps
the direct generated text.
Evaluation
python -m eval intrinsic_physics_part PREDICTIONS \
--output intrinsic_physics_part_metrics.json
Benchmark results are pending.
Intended use and limitations
This checkpoint is intended for research on physical grounding of 3D object parts and for producing candidate simulation parameters that are subsequently validated. It is not a physics simulator, and its estimates should not be treated as measured material properties.
Performance may degrade for incomplete scans, sparse or noisy point clouds, unseen materials, ambiguous part decompositions, unusual scales, or objects far outside the training distribution. Validate predictions before using them in robotics, safety-critical systems, or real-world engineering workflows.
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
- -