Link model card to Hugging Face paper page and add sample usage

README.md

@@ -1,11 +1,11 @@
 ---
 license: other
+pipeline_tag: text-to-3d
 tags:
 - text-to-3d
 - 3d-generation
 - checkpoint
 - geometry-conditioned-generation
-pipeline_tag: text-to-3d
 ---
 
 # Arbor
@@ -30,9 +30,29 @@ Please note: For individuals or organizations generating annual revenue of US $1
 
 - Repository: https://github.com/Stability-AI/arbor
 - Project page: https://arbor.jdihlmann.com/
-- Paper: https://arbor.jdihlmann.com/downloads/arbor_paper.pdf
+- Paper: [Arbor: Explicit Geometric Conditioning for Controllable 3D Asset Generation](https://huggingface.co/papers/2606.23514)
+
+For installation, evaluation, Blender notes, and demo assets, please use the [GitHub repository](https://github.com/Stability-AI/arbor).
+
+## Usage
 
-For installation, inference examples, evaluation, Blender notes, and demo assets, please use the [GitHub repository](https://github.com/Stability-AI/arbor).
+Below is a simple example of using the Python API to run Arbor:
+
+```python
+from pathlib import Path
+from arbor import ArborPipeline, ConstraintSet
+
+pipeline = ArborPipeline(model_dir="artifacts/model")
+result = pipeline.run(
+    prompt="A small red toy piano with a rounded rectangular body.",
+    constraints=ConstraintSet(
+        hull=(Path("examples/constraints/piano__piano_038__8a941e90/hull_constraint.ply"),),
+    ),
+    output_dir="outputs/piano_038",
+    seed=1,
+)
+print(result.mesh_path)
+```
 
 ## Files
 
@@ -69,4 +89,4 @@ Arbor is not intended to generate factual representations of people, events, pro
 
 ## Safety
 
-Users should evaluate generated outputs for their own application constraints and apply additional mitigations where needed. Report safety issues to safety@stability.ai and security issues to security@stability.ai.
+Users should evaluate generated outputs for their own application constraints and apply additional mitigations where needed. Report safety issues to safety@stability.ai and security issues to security@stability.ai.