whatisgithub

What is phenopixel?

ikeda042/phenopixel — explained in plain English

Analysis updated 2026-05-18

279TypeScriptAudience · researcherComplexity · 3/5Setup · moderate

In one sentence

A FastAPI and React web app that detects, labels, and measures individual bacterial cells from Nikon ND2 microscopy files.

Mindmap

mindmap
  root((PhenoPixel))
    What it does
      Detect cell contours
      Annotate cells
      Bulk measurements
    Tech stack
      Python FastAPI
      React
      OpenCV
      SQLite
    Use cases
      Single-cell studies
      Fluorescence imaging
      Export CSV and JSON
    Audience
      Researchers
      Microbiologists

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Upload Nikon ND2 microscopy files and automatically detect individual bacterial cell outlines.

USE CASE 2

Review and relabel automatically detected cells before running bulk measurements.

USE CASE 3

Export cell length, area, and fluorescence intensity data as CSV or JSON for further analysis.

What is it built with?

PythonFastAPIReactOpenCVSQLiteDocker

How does it compare?

ikeda042/phenopixelszedasa/tomodachi-share-miido-md/domd
Stars279281284
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderateeasyeasy
Complexity3/51/52/5
Audienceresearchergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 1h+

Needs Python and Node.js running in separate terminals, though Docker support is also provided.

No license information is stated in the description.

So what is it?

PhenoPixel is a web application built for scientists who work with microscopy images of individual cells, particularly bacteria. It is deployed at Hiroshima University and handles a specific file format called ND2, which is produced by Nikon microscopes. You upload one of those files, the tool finds the outlines of individual cells in the images, and then lets you inspect, label, and measure those cells in detail. The application has a Python backend (FastAPI) and a React frontend. On the backend, it uses a computer-vision library called OpenCV to detect cell contours in microscope images. Each detected cell gets stored in a local SQLite database, and from there you can view the cell in several ways: as a plain outline, as a fluorescence overlay, as a heat map of signal intensity along the cell's length, or as a 256-level intensity map useful for studying where things are located inside the cell. Fluorescence imaging is a lab technique that makes specific molecules glow, and PhenoPixel can handle images with up to four separate fluorescence channels. A key part of the workflow is annotation. Automated cell detection sometimes picks up debris or cells that are stuck together. The annotation screen lets you manually review what was detected and move items into labeled groups before running bulk measurements. Once a group is clean, the bulk engine can calculate cell length, cell area, fluorescence intensity summaries, and other descriptors across the whole population, then export the results as CSV or JSON. Setting it up requires Python and Node.js running in separate terminals. The repository also includes Docker support and a documentation site built with Docusaurus. The project is aimed at researchers running single-cell phenotype studies and provides enough export options to feed the results into standard analysis pipelines.

Copy-paste prompts

Prompt 1
Show me how to set up PhenoPixel's Python backend and React frontend for local development.
Prompt 2
Explain how PhenoPixel detects and labels bacterial cell contours from ND2 microscope files.
Prompt 3
Help me export bulk fluorescence measurements from PhenoPixel as a CSV file for analysis.

Frequently asked questions

What is phenopixel?

A FastAPI and React web app that detects, labels, and measures individual bacterial cells from Nikon ND2 microscopy files.

What language is phenopixel written in?

Mainly TypeScript. The stack also includes Python, FastAPI, React.

What license does phenopixel use?

No license information is stated in the description.

How hard is phenopixel to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is phenopixel for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.