gimpsegany

KO | EN

gitlite — search

#typescript #ai-agents #deepseek-harness #dsh-plugin #open-source #ai #cli #dsh #claude-code #codex #developer-tools #react

★ 45 Open GitHub ↗

Gimp plugin for integration with Meta Segment Anything

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

## GIMP Plugin For Integration With Meta Segment Anything

## Downloads

You can download the latest version of the plugin from the [GitHub Releases page](https://github.com/Shriinivas/gimpsegany/releases/latest).

- `gimp-segany-gimp3.zip`: For GIMP 3

Download the zip file and follow the installation instructions below.

---

This GIMP plugin integrates with Meta's AI-based tool Segment Anything, which enables you to effortlessly isolate objects within raster images directly from GIMP.

This project provides a plugin that supports both **Segment Anything 1 (SAM1)** and **Segment Anything 2 (SAM2)**.

---

## Installation

### Plugin Installation

1.  Go to the [GitHub Releases page](https://github.com/Shriinivas/gimpsegany/releases/latest) and download `gimp-segany-gimp3.zip`.
2.  Extract the zip file in your GIMP `plug-ins` folder. This will create a `seganyplugin` directory with the plugin files inside.
3.  If you are updating, you can extract and replace the existing `seganyplugin` directory.

You can find GIMP's user plugin location in the `Edit > Preferences` menu under the `Folders` section. Here are the default locations for each operating system:

- **Windows:** `C:\Users\[YourUsername]\AppData\Roaming\GIMP\3.0\plug-ins\`
- **Linux:** `~/.config/GIMP/3.0/plug-ins/`
- **macOS:** `~/Library/Application Support/GIMP/3.0/plug-ins/`

After extracting, ensure the plugin script is executable (on Linux and macOS).

### Segment Anything Backend Installation

You need to install the backend for the Segment Anything model you want to use. The plugin can use either SAM1 or SAM2.

#### Segment Anything 2 (SAM2) Installation

You will get the detailed installation instructions about installing Segment Anything 2 on your platform on Meta's github site: https://github.com/facebookresearch/segment-anything-2.

**Prerequisites:**

- Python 3.10 or higher
- PyTorch 2.3.1 or higher

**Installation Steps:**

1. Clone the repository:
   ```bash
   git clone https://github.com/facebookresearch/segment-anything-2.git
   ```
2. Navigate to the directory and install the package:
   ```bash
   cd segment-anything-2 && pip install -e .
   ```
3. Download a model checkpoint (e.g., Tiny, Small, Base Plus, Large).
4. Ensure the `segment-anything-2` directory is in your `PYTHONPATH`.

#### Segment Anything 1 (SAM1) Installation

You will get the detailed installation instructions about installing Segment Anything on your platform on Meta's github site: https://github.com/facebookresearch/segment-anything.

**Installation Steps:**

1. Clone the repository:
   ```bash
   git clone https://github.com/facebookresearch/segment-anything.git
   ```
2. Navigate to the directory and install the package:
   ```bash
   cd segment-anything && pip install -e .
   ```
3. Download a model checkpoint (e.g., `vit_h`, `vit_l`, `vit_b`).
4. Ensure the `segment-anything` directory is in your `PYTHONPATH`.

### Bridge Test

Perform a quick check to ensure your Segment Anything installation is working properly. Open a console and change directory to your GIMP plugin folder.

**For SAM2 model:**

```
/path/to/python3/python ./seganybridge.py sam2_hiera_large /path/to/checkpoint/model/sam2_hiera_large.pth
```

**For SAM1 model:**

```
/path/to/python3/python ./seganybridge.py vit_h /path/to/checkpoint/model/sam_vit_h_4b8939.pth
```

A "Success!!" message indicates a successful installation.

---

## Plugin Usage

- Open GIMP. Under the "Image" menu, you should see a new submenu called "Segment Anything Layers".
- Open an image file and click on the plugin's menu item to bring up the dialog box.

**Plugin UI:**

[//]: # "Add a screenshot of the GIMP 3 plugin UI here"

### Options

- **Python3 Path:** The path to the python3 instance used while running the seganybridge script.
- **Model Type:** The type of the Segment Anything model to use. Can be set to `Auto` to infer from the checkpoint filename (`sam_` prefix for SAM1, `sam2` for SAM2).
- **Checkpoint Path:** The path to the downloaded Segment Anything model checkpoint file (`.pth` or `.safetensors`).
- **Segmentation Type:** The method to be used for segmentation.
  - **Auto:** Automatically segments the entire image.
  - **Box:** Segments objects within a user-drawn rectangular selection.
  - **Selection:** Segments objects based on sample points from a user-drawn selection.
- **Mask Type:**
  - **Multiple:** Creates a separate layer for each potential object.
  - **Single:** Creates a single layer with the mask that has the highest AI probability.
- **Random Mask Color:** If checked, the generated layers will have random colors. Otherwise, a specific color can be chosen.

#### SAM2 Specific Options (for "Auto" Segmentation)

These options are only available when using a SAM2 model with "Auto" segmentation.

- **Segmentation Resolution:** Controls the density of the segmentation grid. Higher values will generate more masks but will be slower. (Options: Low, Medium, High)
- **Crop n Layers:** Enables segmentation on smaller, overlapping crops of the image, which can improve accuracy for smaller objects.
- **Minimum Mask Area:** Discards small, irrelevant masks.

### Workflow

1.  Select your desired options in the plugin dialog and click "OK".
2.  The plugin will create a new layer group with one or more mask layers.
3.  Find the mask layer corresponding to the object you want to isolate.
4.  Select that layer and use the "Fuzzy Selection" tool to select the mask area.
5.  Hide the new layer group and select your original image layer.
6.  You can now cut, copy, or perform any other GIMP operation on the selected object.

gimpsegany

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README