combaero-gui 0.2.0

CombAero Network GUI — React/FastAPI desktop application

CombAero Network Designer GUI

Interactive design and diagnostic environment for fluid-thermal networks.

The CombAero GUI allows for rapid construction of complex aerospace networks using a drag-and-drop interface powered by React Flow and a high-performance C++ backend.

Quick Start

1. Environment Setup

Ensure the GUI components are installed:

uv pip install -e ".[gui]"

2. Launch

The GUI can be launched with a single command:

combaero-gui

This starts both the FastAPI backend and the Vite-based frontend.

Key Workflows

• Build: Drag nodes (Plenums, Boundaries) and elements (Orifices, Channels) from the sidebar.
• Connect: Click and drag from node handles to element ports.
• Solve: Click the Solve button in the header. Successful solves turn node borders green.
• Inspect: Click on any node or element to view real-time diagnostics in the Inspector sidebar.

---

Agent Reference (UI Automation Map)

For agents with screen control (multimodal LLMs), the following selectors and IDs are provided to assist in navigation:

UI Component	Selector / ID	Description
Solve Button	#solve-btn	Triggers the network solve.
Inspector Sidebar	.inspector-panel	Properties for selected node/element.
Network Canvas	#rf-canvas	The main React Flow workspace.
Node (General)	.react-flow__node	Any node on the canvas.
Solved Indicator	.solved-status-ok	Appears on nodes after a successful solve.
Error Console	#error-output	Displays solver convergence failures.

[!TIP] Automation Hint: To add a node via script, use the gui.backend API or generate a network JSON and load it via File -> Import.

Technical Reference

For internal data structures and JSON schemas, see docs/GUI_TECHNICAL.md.