Computer Vision Platform (YOLO + FastAPI + React)

Public repository for a modular computer-vision platform centered on YOLO inference, API-first integration, and a redesign-ready frontend shell.

About

This project provides a practical foundation for computer-vision products:

• Backend API for inference and demo entry points (apps/fastapi)
• Shared vision core for reusable model logic (core/vision)
• RTSP scripts for stream-based workflows (scripts/rtsp)
• Frontend shell for operator workflows (cv-platform-ui)

The repository is organized for incremental delivery: stable contracts first, feature growth second, and UI redesign integration without breaking runtime boundaries.

Canonical project truth

Canonical implementation paths (must remain stable):

• apps/fastapi
• core/vision
• scripts/rtsp
• cv-platform-ui

Root Python files (yolo_api_v2.py, yolo_api_v3.py, api_server.py, etc.) are compatibility wrappers.

Repository structure

Computer Vision/
├─ apps/
│  ├─ fastapi/
│  └─ nicegui/
├─ core/
│  └─ vision/
├─ scripts/
│  └─ rtsp/
├─ cv-platform-ui/
├─ platform/
│  ├─ edge-llm/
│  └─ orchestration/
└─ docs/
   ├─ agent/
   ├─ designs/
   ├─ maps/
   ├─ redesign/
   └─ roadmap/

Architecture references:

• docs/ARCHITECTURE.md
• docs/maps/01_STRUCTURE_MAP.md
• docs/maps/02_RUNTIME_MAP.md

Frontend redesign preparation status

• Active frontend path remains cv-platform-ui/ (not renamed).
• Route source of truth remains cv-platform-ui/src/App.jsx.
• API boundary is converged to cv-platform-ui/src/services/*.
• Current redesign planning docs live under:
  • docs/designs/base44/
  • docs/redesign/BASE44_INTAKE.md
  • docs/redesign/FRONTEND_GAP_ANALYSIS.md

Current live backend compatibility endpoints

apps.fastapi.yolo_api_v3:app (frontend integration target)

• GET /
• POST /demo
• GET /health
• GET /integration/demo-entry
• POST /predict
• POST /predict/annotated

apps.fastapi.yolo_api_v2:app (compatibility flow)

• GET /
• POST /demo
• GET /health
• POST /predict
• POST /predict/annotated

apps.fastapi.api_server:app (service-style compatibility API)

• GET /
• POST /app/detect
• POST /detect/image
• POST /detect/image/annotated

Public repository safety

This repository is public.

Do not commit sensitive/internal-only content to tracked paths. Use private ignored tracks such as:

• private/
• docs/private/
• docs/roadmap-private/
• cv-platform-ui-private/
• cv-platform-ui/src/private/

Policy reference: docs/PRIVATE_WORKFLOW.md

Manual run commands (user-executed)

Backend (v3 integration target)

.\.venv\Scripts\Activate.ps1
python -m uvicorn apps.fastapi.yolo_api_v3:app --host 0.0.0.0 --port 8002

Frontend

cd cv-platform-ui
npm install
npm run dev

Optional build check (frontend)

cd cv-platform-ui
npm run build

Future platform direction

• preserve modular backend/core boundaries
• keep frontend mock-first for surfaces without live APIs
• expand assistant capabilities with platform/edge-llm
• evolve orchestration workflows under platform/orchestration

Attribution

Author: He Hao (Seapower).

Some script/notebook content originated during affiliation with SeaPower Lab (Núcleo Defesa / Defense). This repository version does not include SeaPower Lab confidential information.