ImportError: No module named 'sam3.sam' on fresh install

[jspinak]

Environment

• OS: Windows 11
• Python: 3.12.0
• Installation method: pip install git+https://github.com/facebookresearch/sam3.git
• SAM3 version: 0.1.0

Issue

Fresh installation of SAM3 fails to import due to a missing internal module reference.

Steps to reproduce

pip install git+https://github.com/facebookresearch/sam3.git
python -c "import sam3"

Error

Traceback (most recent call last):
  File "<string>", line 1, in <module>
  File "...\sam3\__init__.py", line 3, in <module>
    from .model_builder import build_sam3_image_model
  File "...\sam3\model_builder.py", line 10, in <module>
    from sam3.model.decoder import (
  File "...\sam3\model\decoder.py", line 13, in <module>
    from sam3.sam.transformer import RoPEAttention
ModuleNotFoundError: No module named 'sam3.sam'

Analysis

The package references sam3.sam.transformer but no sam3/sam/ directory exists in the installed package. It appears this submodule may be missing from the repository or the import
 path is incorrect.

Expected behavior

import sam3 should work without errors after installation.

[kodaigit]

did you call it from a folder where you clone the sam3 repo?

[jonlwowski012]

@kodaigit I am experiencing the same issue. This is with a pip install not cloning the repo

[JRJacoby]

Yeah they need to add sam3.sam to their pyproject.toml in addition to sam3 and sam3.model. Otherwise for instance uv pip installing by pointing to the git repo doesn't work. The cloning and locally editably installing isn't viable when I'm trying to make this a dependency of a package I'm building.

[harry83017622]

I experienced the same issue and added one line in pyproject.toml like this. It works

[tool.setuptools]
packages = ["sam", "sam3.model", "sam3.sam"]

Then installed by the local reference like this

dependencies = [
  "sam3[notebooks, dev, train] @ file:///your-project-path/sam3",
]

[lematt1991]

This should now be resolved by #327