orangeshushu commited on
Commit
9d6d43f
·
verified ·
1 Parent(s): f8e4d1a

Add v3.2.0 Windows .exe and macOS arm64 .dmg installers; refresh model card

Browse files
.gitattributes CHANGED
@@ -34,3 +34,5 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
34
  *.zst filter=lfs diff=lfs merge=lfs -text
35
  *tfevents* filter=lfs diff=lfs merge=lfs -text
36
  TOM.exe filter=lfs diff=lfs merge=lfs -text
 
 
 
34
  *.zst filter=lfs diff=lfs merge=lfs -text
35
  *tfevents* filter=lfs diff=lfs merge=lfs -text
36
  TOM.exe filter=lfs diff=lfs merge=lfs -text
37
+ TOM-Tongue-Segmentation-v3.2.0.exe filter=lfs diff=lfs merge=lfs -text
38
+ TOM-Tongue-Segmentation-v3.2.0-arm64.dmg filter=lfs diff=lfs merge=lfs -text
README.md CHANGED
@@ -1,3 +1,203 @@
1
- ---
2
- license: mit
3
- ---
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ license: mit
3
+ language:
4
+ - en
5
+ - zh
6
+ tags:
7
+ - tongue-segmentation
8
+ - tcm
9
+ - traditional-chinese-medicine
10
+ - medical-imaging
11
+ - image-segmentation
12
+ - desktop-app
13
+ library_name: pytorch
14
+ pipeline_tag: image-segmentation
15
+ ---
16
+
17
+ # TOM 舌象分割工具 · TOM Tongue Segmentation
18
+
19
+ > AI 驱动的中医舌象智能分割工具 · AI-powered tongue segmentation for TCM research
20
+
21
+ <p align="center">
22
+ <img src="https://raw.githubusercontent.com/orangeshushu/TOM-Tongue-Segmentation-Model/main/docs/assets/icon.png" alt="TOM app icon" width="128">
23
+ </p>
24
+
25
+ [![GitHub](https://img.shields.io/badge/GitHub-orangeshushu%2FTOM--Tongue--Segmentation--Model-black?logo=github)](https://github.com/orangeshushu/TOM-Tongue-Segmentation-Model)
26
+ [![Release](https://img.shields.io/github/v/release/orangeshushu/TOM-Tongue-Segmentation-Model)](https://github.com/orangeshushu/TOM-Tongue-Segmentation-Model/releases)
27
+ [![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS-blue)](https://github.com/orangeshushu/TOM-Tongue-Segmentation-Model/releases)
28
+ [![License](https://img.shields.io/badge/license-MIT-green)](https://github.com/orangeshushu/TOM-Tongue-Segmentation-Model/blob/main/LICENSE)
29
+
30
+ **[🇨🇳 中文](#-中文版) · [🇺🇸 English](#-english)**
31
+
32
+ ---
33
+
34
+ ## 🇨🇳 中文版
35
+
36
+ 一款面向中医研究与临床的舌象分割桌面工具,自动从舌头照片中分离出舌体区域,支持单张精修和批量处理。
37
+
38
+ ### ✨ 功能特性
39
+
40
+ - 🎯 **一键自动分割** —— 打开图片即自动识别舌头区域,通常 1–3 秒完成
41
+ - 🎨 **交互式微调** —— 通过点击 / 框选快速修正分割结果,每次标注后自动重算
42
+ - 📁 **批量处理** —— 整个文件夹一次性处理,可同时输出多种格式
43
+ - 💾 **三种输出格式** —— 透明背景 PNG · 二值掩膜 · 叠加可视化
44
+ - ⚡ **高精度模式** —— 可选 GrabCut 边界精修,更贴合舌体边缘
45
+ - 🌏 **中英双语界面** —— 一键切换中文 / English
46
+ - 🪟 **绿色安装** —— 双击安装即用,无需 Python / CUDA 环境
47
+
48
+ ### 📥 下载安装
49
+
50
+ 可直接从本仓库下载,或前往 [**GitHub Releases**](https://github.com/orangeshushu/TOM-Tongue-Segmentation-Model/releases) 页面:
51
+
52
+ | 文件 | 大小 | 平台 |
53
+ |---|---|---|
54
+ | [`TOM-Tongue-Segmentation-v3.2.0.exe`](./TOM-Tongue-Segmentation-v3.2.0.exe) | 565 MB | Windows 10 / 11(64 位) |
55
+ | [`TOM-Tongue-Segmentation-v3.2.0-arm64.dmg`](./TOM-Tongue-Segmentation-v3.2.0-arm64.dmg) | 354 MB | macOS 11+(Apple Silicon) |
56
+
57
+ **Windows**:双击 `.exe` 运行安装向导,可选择:
58
+ - **语言**:中文 / English(界面语言可在安装后随时切换)
59
+ - **安装位置**:默认 `%LOCALAPPDATA%\Programs\TOM舌象分割工具\`
60
+ - **桌面快捷方式**:是否创建
61
+
62
+ 安装完成后从开始菜单或桌面快捷方式启动。
63
+
64
+ **macOS**:双击 `.dmg` 挂载,将 `TOM Tongue Segmentation.app` 拖入 `Applications` 文件夹即可。首次启动时由于未经 Apple 公证,可能提示「无法验证开发者」——请在 `Applications` 中**右键点击应用 → 选择「打开」→ 在弹窗中再次点「打开」**即可正常运行,之后双击启动不再提示。
65
+
66
+ ### 🚀 使用方法
67
+
68
+ #### 单张图片处理
69
+
70
+ ![单张图片界面](https://raw.githubusercontent.com/orangeshushu/TOM-Tongue-Segmentation-Model/main/docs/main_zh_single.png)
71
+
72
+ 1. 点击 **打开图片**,选择一张舌头照片
73
+ 2. 等待 1–3 秒,应用自动完成分割
74
+ 3. 如对结果不满意,可进行交互式微调:
75
+ - **Shift + 左键拖动**:框选舌头区域(最准确)
76
+ - **左键点击**:标记舌头(前景点)
77
+ - **右键点击**:标记背景
78
+ - 每次标注后会自动重新分割
79
+ 4. 满意后点击 **保存结果**,选择输出文件夹
80
+ 5. 自动生成三种输出:透明背景 PNG · 二值掩膜 · 叠加可视化图
81
+
82
+ #### 批量处理
83
+
84
+ ![批量处理界面](https://raw.githubusercontent.com/orangeshushu/TOM-Tongue-Segmentation-Model/main/docs/main_zh_batch.png)
85
+
86
+ 1. 切换到 **批量处理** 标签页
87
+ 2. 选择 **输入文件夹**(内含待处理的舌头图片)
88
+ 3. 选择 **输出文件夹**
89
+ 4. 勾选需要的输出类型(抠图 / 掩膜 / 叠加图)
90
+ 5. 可选:勾选 **高精度模式**(GrabCut 边界精修,每张多耗时约零点几秒)
91
+ 6. 点击 **开始批量分割**
92
+ 7. 进度条和日志会实时显示处理状态
93
+
94
+ 支持的图片格式:`.jpg` `.jpeg` `.png` `.bmp` `.tif` `.tiff` `.webp`
95
+
96
+ #### 切换语言
97
+
98
+ 点击右上角 **EN / 中** 按钮即可在中英文之间切换。
99
+
100
+ ### 📋 系统要求
101
+
102
+ - **操作系统**:Windows 10 / 11(64 位)· macOS 11 Big Sur 或更高(Apple Silicon,M1/M2/M3/M4)
103
+ - **内存**:4 GB RAM 以上(推荐 8 GB)
104
+ - **磁盘空间**:约 1.5 GB
105
+ - **加速**:Windows 可选 GPU 加速 · macOS 自动启用 Apple MPS 加速(CPU 也能正常运行)
106
+
107
+ ---
108
+
109
+ ## 🇺🇸 English
110
+
111
+ A desktop tongue-segmentation tool for TCM research and clinical use. Automatically isolates the tongue region from a photograph, with support for single-image fine-tuning and batch processing.
112
+
113
+ ### ✨ Features
114
+
115
+ - 🎯 **One-click auto segmentation** — Tongue region is identified automatically on opening, typically in 1–3 seconds
116
+ - 🎨 **Interactive fine-tuning** — Click / box-select to correct results; re-segments after every edit
117
+ - 📁 **Batch processing** — Process an entire folder at once, output multiple formats simultaneously
118
+ - 💾 **Three output formats** — Transparent PNG cutout · Binary mask · Overlay visualization
119
+ - ⚡ **High-accuracy mode** — Optional GrabCut boundary refinement for tighter edges
120
+ - 🌏 **Bilingual UI** — Switch between English and 中文 with one click
121
+ - 🪟 **Standalone install** — Double-click installer, no Python / CUDA setup required
122
+
123
+ ### 📥 Download & Install
124
+
125
+ Download directly from this repository, or visit the [**GitHub Releases**](https://github.com/orangeshushu/TOM-Tongue-Segmentation-Model/releases) page:
126
+
127
+ | File | Size | Platform |
128
+ |---|---|---|
129
+ | [`TOM-Tongue-Segmentation-v3.2.0.exe`](./TOM-Tongue-Segmentation-v3.2.0.exe) | 565 MB | Windows 10 / 11 (64-bit) |
130
+ | [`TOM-Tongue-Segmentation-v3.2.0-arm64.dmg`](./TOM-Tongue-Segmentation-v3.2.0-arm64.dmg) | 354 MB | macOS 11+ (Apple Silicon) |
131
+
132
+ **Windows**: Double-click the `.exe` to run the installer wizard, which lets you choose:
133
+ - **Language**: 中文 / English (UI language can be switched anytime after install)
134
+ - **Install location**: defaults to `%LOCALAPPDATA%\Programs\TOM Tongue Segmentation\`
135
+ - **Desktop shortcut**: yes / no
136
+
137
+ Launch from the Start menu or desktop shortcut after install.
138
+
139
+ **macOS**: Double-click the `.dmg` to mount it, then drag `TOM Tongue Segmentation.app` into the `Applications` folder. Because the bundle is not Apple-notarized, the first launch may show *"cannot be verified"*. To get past it, **right-click the app in `Applications` → Open → Open** in the confirmation dialog. After that first launch, double-clicking works normally.
140
+
141
+ ### 🚀 How to Use
142
+
143
+ #### Single Image
144
+
145
+ ![Single image UI](https://raw.githubusercontent.com/orangeshushu/TOM-Tongue-Segmentation-Model/main/docs/main_en_single.png)
146
+
147
+ 1. Click **Open Image** and pick a tongue photo
148
+ 2. Wait 1–3 seconds — the app segments automatically
149
+ 3. If you want to refine the result:
150
+ - **Shift + left-drag**: box the tongue region (most accurate)
151
+ - **Left click**: add a foreground (tongue) point
152
+ - **Right click**: mark background
153
+ - Re-segmentation runs after every edit
154
+ 4. When satisfied, click **Save Results** and pick an output folder
155
+ 5. Three outputs are produced: transparent PNG · binary mask · overlay visualization
156
+
157
+ #### Batch Folder
158
+
159
+ ![Batch UI](https://raw.githubusercontent.com/orangeshushu/TOM-Tongue-Segmentation-Model/main/docs/main_en_batch.png)
160
+
161
+ 1. Switch to the **Batch Folder** tab
162
+ 2. Pick an **Input folder** (containing tongue images)
163
+ 3. Pick an **Output folder**
164
+ 4. Tick which output types you want (cutout / mask / overlay)
165
+ 5. Optional: enable **High accuracy** (GrabCut edge refine, adds a fraction of a second per image)
166
+ 6. Click **Start batch**
167
+ 7. Progress bar and log update in real time
168
+
169
+ Supported image formats: `.jpg` `.jpeg` `.png` `.bmp` `.tif` `.tiff` `.webp`
170
+
171
+ #### Switching Language
172
+
173
+ Click the **EN / 中** button at the top-right to toggle between English and Chinese.
174
+
175
+ ### 📋 System Requirements
176
+
177
+ - **OS**: Windows 10 / 11 (64-bit) · macOS 11 Big Sur or newer (Apple Silicon, M1/M2/M3/M4)
178
+ - **RAM**: 4 GB or more (8 GB recommended)
179
+ - **Disk**: ~1.5 GB
180
+ - **Acceleration**: Optional GPU on Windows · Apple MPS used automatically on macOS (CPU also works)
181
+
182
+ ---
183
+
184
+ ## 📖 引用 · Citation
185
+
186
+ 如本工具对您的研究有帮助,欢迎引用我们的文章。
187
+ If this tool helps your research, please cite our paper:
188
+
189
+ > Xie, J., Zhang, Z., Poudel, B., Guo, C., Yu, Y., An, G., ... & Xu, D. (2026). **TOM: An open-source tongue segmentation method with multi-teacher distillation and task-specific data augmentation.** *Expert Systems with Applications*, 131499.
190
+
191
+ 🔗 [View on ScienceDirect](https://www.sciencedirect.com/science/article/pii/S0957417426004124)
192
+
193
+ ## 🏛️ 研发团队 · Developed by
194
+
195
+ **[Digital Biology Laboratory (DBL)](https://digbio.missouri.edu/)**
196
+ University of Missouri
197
+
198
+ 如本工具对您有帮助,欢迎给我们一个 ⭐ Star 以获取后续更新通知。
199
+ If this tool helps you, a ⭐ star is appreciated — and you'll get notified of future updates.
200
+
201
+ ## 📄 版权 · Copyright
202
+
203
+ © 2026 Digital Biology Laboratory · University of Missouri
TOM.exe → TOM-Tongue-Segmentation-v3.2.0-arm64.dmg RENAMED
@@ -1,3 +1,3 @@
1
  version https://git-lfs.github.com/spec/v1
2
- oid sha256:96bdcb20f03ffb640e0e82edbbd9644835a0d8f3995f5bb010177046c3ed7aae
3
- size 1708412928
 
1
  version https://git-lfs.github.com/spec/v1
2
+ oid sha256:72cdebe4f6bba1ffb65b34d050e77b075608bcbf7d51ec4b2ae80f6686ff74ba
3
+ size 371092898
TOM-Tongue-Segmentation-v3.2.0.exe ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:d615c1c5ca8143fcf1e8b860f22b74661412c24d80c7cc0d387d41b65a82d377
3
+ size 592040291