magogi/prod/: hrb-app-0.2.1 metadata and description

Simple index

Magogi Foundation Hardware Resource Broker — GUI front-end for the mgf-hrb library.

author Bassam Alsanie, hrb-app contributors
description_content_type text/markdown
license MIT
license_file
  • LICENSE
metadata_version 2.4
project_urls
  • Homepage, https://codeberg.org/magogi-admin/hrb-app
  • Issues, https://codeberg.org/magogi-admin/hrb-app/issues
  • Feedback, https://codeberg.org/magogi-admin/hrb-app/src/branch/main/FEEDBACK.md
requires_dist
  • mgf-brand-qt<0.2,>=0.1.3
  • mgf-common<0.53,>=0.51
  • mgf-hrb<0.2,>=0.1
  • mgf-logship<0.2,>=0.1.6
  • pyside6<7.0,>=6.7
  • qasync<0.28,>=0.27
  • hypothesis>=6.100; extra == 'dev'
  • import-linter<3.0,>=2.0; extra == 'dev'
  • mgf-fed[cli]>=0.1; extra == 'dev'
  • mgf-standard<0.2,>=0.1.57; extra == 'dev'
  • mgf-test-supervisor<0.2,>=0.1.20; extra == 'dev'
  • mgf-uitest-desktop<0.2,>=0.1.2; extra == 'dev'
  • mypy>=1.10; extra == 'dev'
  • pytest-asyncio>=0.23; extra == 'dev'
  • pytest-cov>=5.0; extra == 'dev'
  • pytest-qt>=4.4; extra == 'dev'
  • pytest-timeout>=2.3; extra == 'dev'
  • pytest>=8.0; extra == 'dev'
  • ruff>=0.4; extra == 'dev'
requires_python >=3.13

Because this project isn't in the mirror_whitelist, no releases from root/pypi are included.

File Tox results History
hrb_app-0.2.1-py3-none-any.whl
Size
179 KB
Type
Python Wheel
Python
3

hrb-app — GUI front-end for mgf-hrb

Shape. Magogi Foundation consumer application. Federation pins declared in pyproject.toml; pin-bump history in docs/inprogress/MGF_ADOPTION.md §4. Conformance level. L2 — Standard (declared; per-rule audit in docs/inprogress/MGF_STANDARDS_CONFORMANCE.md). Status. 0.2.0 — released (see CHANGELOG.md). The GUI runs against a real mgf-hrb broker: device tree (fd-driven subscription), capabilities, inspect, doctor, and an all-operators lease pane are all wired. See QUICKSTART.md to launch it; STARTHERE.md for the deeper navigator.

A desktop GUI for the mgf-hrb Hardware Resource Broker. Renders the broker's device tree, leases, and operator surfaces (the equivalent of mgf-hrb scan / mgf-hrb doctor) for humans who don't want to drive the CLI.

Presentation layer: PySide6 (Qt 6) with qasync bridging Qt's event loop to asyncio. Multi-operator (multiple humans driving the same broker concurrently) is a day-1 design constraint — the broker is the single source of truth; the GUI is one of N clients. See docs/inprogress/PRESENTATION_LAYER_RESEARCH.md §0 for the decision and the discipline points that flow from it.

Roadmap. (Per-phase status + notes live in docs/inprogress/MGF_ADOPTION.md §3.)

Quick start

git clone https://codeberg.org/magogi-admin/hrb-app.git
cd hrb-app && uv venv && uv pip install -e '.[dev]'
uv run hrb-app --socket /tmp/mgf-hrb.sock

Full setup (incl. the broker side, settings, what-you-see, troubleshooting) → QUICKSTART.md. Developer onboarding + AI-agent setup + federation discipline → STARTHERE.md.

Four green gates

ruff check src tests
mypy --strict src/
pytest --cov --cov-fail-under=80
lint-imports

Federation

This project depends on mgf-common and follows the Magogi engineering bar. For AI agents: run mgf-fed agents for the canonical federation briefing, then docs/CLAUDE.md for the project-specific Claude reference. (The federation CLI lives in mgf-fed[cli], a [dev] extra — mgf-common has been a pure library since 0.47.)

License

MIT.