uqer1244/mlx_lingbot-map

MLX LingBot-MAP Weights

Native Apple Silicon (Metal GPU) Accelerated Weights for LingBot-MAP / Geometric Context Transformer (GCT), converted for Apple MLX.

• Original Project Repository: Robbyant/lingbot-map
• Original PyTorch Weights: robbyant/lingbot-map
• MLX Model Repository: uqer1244/mlx_lingbot-map
• Primary Weight File: lingbot-map-fp16.safetensors (~2.16 GB)
• License: Apache License 2.0

---

📦 Available Model Weight Variants

We provide pre-converted MLX safetensors weights in 5 precision formats:

Format / Precision	File Name	Size	Target Hardware / Description
FP16 (Recommended)	lingbot-map-fp16.safetensors	2.16 GB	Default recommended precision for M1/M2/M3/M4 GPUs
FP32	lingbot-map-fp32.safetensors	4.31 GB	Full precision reference weights
BF16	lingbot-map-bf16.safetensors	2.16 GB	BFloat16 precision for M2 / M3 / M4 Apple Silicon
INT8	lingbot-map-int8.safetensors	1.24 GB	8-bit Group-wise Affine Quantization for low-memory devices
INT4	lingbot-map-int4.safetensors	0.72 GB	4-bit Group-wise Affine Quantization for minimal RAM usage

---

🚀 Quick Usage Guide

1. Download via Hugging Face Hub (Python)

from huggingface_hub import hf_hub_download
# Download default FP16 MLX safetensors weight file
weights_path = hf_hub_download(
    repo_id="uqer1244/mlx_lingbot-map",
    filename="lingbot-map-fp16.safetensors",
    local_dir="checkpoints"
)
print(f"Weights downloaded to: {weights_path}")

2. Load Weights into MLX

import mlx.core as mx
# Load safetensors directly in MLX
weights = mx.load("checkpoints/lingbot-map-fp16.safetensors")
print(f"Loaded {len(weights)} MLX layer tensors!")

3. Run Streaming 3D Reconstruction Demo

Clone the MLX project repository:

git clone https://github.com/anmolduainter/lingbot-map-mlx.git
cd mlx-lingbot-map
pip install -e .
# Run streaming 3D reconstruction
python create_map.py --image_folder path/to/images --stride 2 --out_map maps/reconstruction_map.npz
# Launch interactive 3D Web Visualizer
python view_map.py --map_file maps/reconstruction_map.npz --port 8080

---

📜 Acknowledgements & Citation

This model weight repository contains MLX-converted .safetensors derived from the original LingBot-MAP project created by the Robbyant team:

• Original Code Repository: https://github.com/Robbyant/lingbot-map
• Original Model Weights: https://huggingface.co/robbyant/lingbot-map

---

📄 License

This model weight repository is released under the Apache License 2.0.