cellpose-web/README.md
ClovertaTheTrilobita 4887441d3c
Add image to README for visual enhancement
Added an image to the README for better visual representation.
2025-10-17 11:29:43 +00:00

4.3 KiB
Raw Permalink Blame History

cellpose web

🛰️一个cellpose的简单web前后端🛰️

Static Badge Static Badge Static Badge Static Badge

image


🌈 实现功能:

  • 🚀 一键上传,在线调参
  • 训练、分割结果随时下载
  • 📚 权重可直接作为后续分割模型
  • 🛠️ 一键安装部署脚本
  • 🎨 前端样式美化

🚀一键安装

最新Release页面中下载最新的 install.sh 到你的Linux/macOS机器上。

将它放到你希望项目存在的位置,并执行它,安装脚本会将项目自动拉取到同一目录下。

NOTE: 安装脚本设计上支持Debian系、Arch系、RHEL系Linux,但目前仅测试过Arch Linux。其他发行版暂未经过测试若出现意外错误推荐手动安装。

Windows暂时不支持通过脚本一键安装。


🛠️手动部署

0. 克隆本仓库至本地

git clone https://github.com/ClovertaTheTrilobita/cellpose-web.git

1.修改配置文件

后端配置文件位于backend/config.yaml

默认配置如下:

backend:
  ip: 192.168.193.141
  port: 5000

model:
  save_dir: models

data:
  root_dir: .

  run:
    test_output_dir: ${data.root_dir}/run/test_output
    output_dir: ${data.root_dir}/run/output

  train:
    test_test_dir: ${data.root_dir}/train/test_test
    test_train_dir: ${data.root_dir}/train/test_train
    test_dir: ${data.root_dir}/train/test
    train_dir: ${data.root_dir}/train/train

  upload_dir: ${data.root_dir}/uploads

请修改ip字段为你PC/服务器的ip。

前端配置文件位于fronted/api.js

默认配置如下:

const config = {
  server: {
    protocol: 'http',
    host: '192.168.193.141',
    port: 5000
  }
};

const API_BASE = `${config.server.protocol}://${config.server.host}:${config.server.port}/`;

请将hostport设置为和后端一致。

2.Conda

推荐你使用conda作为Python环境管理器。

Anaconda官网https://www.anaconda.com/

conda create -n cpweb python=3.12

3.安装redis

项目使用redis作为临时存储数据库。在启动前你需要先安装它:

  • Windows

    详见官方手册:Install Redis on Windows | Docs

    Windows上推荐使用PhpStudy管理redisphpstudy - Windows | 小皮面板

  • Debian/Ubuntu

    sudo apt install redis-server
    

    安装完成后Redis服务会自动启动。您可以使用以下命令检查Redis服务的状态

    sudo systemctl status redis-server
    
  • Arch Linux

    由于redis政策其已从Arch官方仓库中移除你可以安装redis的开源分支valkey功能与redis完全相同

    sudo pacman -S valkey
    sudo systemctl enable --now valkey
    

4.安装依赖

启用你的Conda环境并安装依赖

conda activate cpweb
pip install -r requirements.txt

5. 启动后端

cd backend/
python main.py

这会在你的机器上启动flask后端。默认监听5000端口。

6.关于默认前端

项目有一个简单的默认前端。你可以配置Nginx实现从浏览器访问这几个HTML文件。

请将Nginx指向frontend/index.html

如果你在本地部署,你可以在启动后端后直接打开index.html,开始使用。

⚖️License

This project is licensed under the Apache-2.0 license.

It also includes code and ideas from the Cellpose project, which is licensed under the BSD 3-Clause License.