SoFar  by qizekun

System for 6-DoF spatial reasoning and robotic manipulation

Created 1 year ago
253 stars

Top 99.6% on SourcePulse

GitHubView on GitHub
Project Summary

Summary

SoFar addresses the challenge of language-grounded spatial reasoning and 6-DoF robotic manipulation. It introduces the novel concept of "semantic orientation" to bridge open-vocabulary language understanding with precise object manipulation. This system benefits researchers and engineers by enabling robots to perform complex rearrangement and manipulation tasks guided by natural language instructions.

How It Works

The core innovation is "semantic orientation," which defines object orientation based on open-vocabulary language descriptions. SoFar leverages mature Vision-Language Models (VLMs) such as Qwen, ChatGPT, and Gemini, integrating their language comprehension capabilities with spatial reasoning modules. This approach allows for nuanced understanding and execution of manipulation commands that go beyond simple positional changes, enabling robots to handle orientation-specific tasks effectively.

Quick Start & Requirements

Installation involves creating a Python 3.12 Conda environment, cloning the repository, and installing dependencies via pip. Key prerequisites include downloading pre-trained checkpoints for Florence-2, Segment Anything (SAM), and PointSO. Integration with VLMs requires either an OpenAI API key or the setup of Qwen-VL-2.5 with specific libraries like qwen-vl-utils and flash-attn. CPU inference is supported on MacOS and Windows. Detailed instructions are available in INSTALL.md.

Highlighted Details

  • Achieves State-of-the-Art (SOTA) performance on benchmarks like SimplerEnv (Object Manipulation) and Open6DOR V2 (6-DoF Object Rearrangement).
  • Introduces the concept of "semantic orientation" for language-grounded spatial reasoning.
  • Provides comprehensive datasets for training and evaluation: OrienText300K, Open6DOR V2, and 6-DoF SpatialBench.
  • Demonstrates strong performance on the 6-DoF SpatialBench, outperforming other models in position and orientation tasks.

Maintenance & Community

The project appears to be a research initiative with multiple authors. A "TODO" list indicates ongoing development, with plans for improved datasets and demos. Direct community channels (like Discord/Slack) are not specified, but an email contact is provided for inquiries.

Licensing & Compatibility

The provided README does not explicitly state the software license. This omission requires further investigation for users considering commercial use or integration into closed-source projects.

Limitations & Caveats

The project is actively under development, with several features and datasets listed as "TODO," suggesting potential for breaking changes or incomplete functionality. Specific benchmark coordinate system conventions, such as for Open6DOR, require careful attention during implementation.

Health Check
Last Commit

1 year ago

Responsiveness

1 day

Pull Requests (30d)
0
Issues (30d)
0
Star History
1 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.