opdmulti-demo / README.md
atwang's picture
local app demo is working
6d737eb
|
raw
history blame
1.55 kB
metadata
title: Opdmulti Demo
emoji: 🌍
colorFrom: gray
colorTo: red
sdk: gradio
sdk_version: 3.44.3
app_file: app.py
pinned: false
license: mit

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference

Installation

To setup the environment, run the following (recommended in a virtual environment):

# install base requirements
pip install -r pre-requirements.txt
pip install -r requirements.txt

cd mask2former/modeling/pixel_decoder/ops
python setup.py build install

# Option A: running locally only
pip install open3d==0.17.0

# Option B: running over ssh connection / headless environment
# in a separate folder
git clone https://github.com/isl-org/Open3D.git
cd Open3D/
mkdir build && cd build
cmake -DENABLE_HEADLESS_RENDERING=ON -DBUILD_GUI=OFF -DBUILD_WEBRTC=OFF -DUSE_SYSTEM_GLEW=OFF -DUSE_SYSTEM_GLFW=OFF ..
make -j$(nproc)
make install-pip-package
# to test custom build
cd ../examples/python/visualization/
python headless_rendering.py

The setup with pre-requirements.txt and requirements.txt resolves the issue that certain packages need to be installed prior to others. By default, most additional packages should be added to requirements.txt.

Usage

To startup the application locally, run

gradio app.py

You can view the app on the specified port (usually 7860). To run over an ssh connection, setup port forwarding using -L 7860:localhost:7860 when you create your ssh connection. Note that you will need to install Open3D in headless rendering for this to work.