[JarbasAl]

Splits the admin web UI out of core. The UI itself now lives in its own repo, JarbasHiveMind/hivemind-admin-panel (AGPL-3.0); this PR keeps only a thin, optional launcher in core.

What this adds to core

• --with-admin / --admin-host / --admin-port flags
• HiveMindService._start_admin() — lazily imports hivemind_admin_panel and injects live service/db/protocol for real-time introspection; started early in run() so the panel stays reachable even if the agent protocol blocks
• [admin] extra now depends on hivemind-admin-panel instead of pulling fastapi/uvicorn/python-multipart into core
• exposes the live protocol instance on the service for the panel

Core has no hard dependency on the panel: without [admin] installed, --with-admin warns and core runs normally.

Why

The previous approach (#72) bundled ~11k lines of FastAPI backend + JS SPA + a Jest suite inside core, under an AGPL header that clashed with core's Apache license and forced a license-audit exclusion. Extracting it gives the panel its own release cadence and license boundary, keeps the admin plane (pip-install / DB-migration / restart endpoints) optional and separately deployable, and keeps a Node toolchain out of the core repo.

Relationship to #72

Supersedes #72, which is ~46 commits behind dev (pre bus-client 2.x). This branch is cut from current dev. Suggest closing #72 once this lands.

Gating

[admin] references hivemind-admin-panel>=0.0.1a1, which must be published before pip install hivemind-core[admin] resolves. It's an optional extra, so core's own build/tests are unaffected.

🤖 Generated with Claude Code

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 7d4a8eae-09ce-4f0b-8a94-4348d127e56f

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feat/admin-panel-launcher

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[github-actions]

Beep! Your PR results are served. 🍽️

I've aggregated the results of the automated checks for this PR below.

📋 Repo Health

Ensuring the repository stays strong and healthy. 💪

✅ All required files present.

Latest Version: 4.6.3a1

✅ hivemind_core/version.py — Version file
✅ README.md — README
✅ LICENSE — License file
✅ pyproject.toml — pyproject.toml
⚠️ setup.py — setup.py
✅ CHANGELOG.md — Changelog
✅ hivemind_core/version.py has valid version block markers

🔍 Lint

Another piece of the puzzle! 🧩

❌ ruff: issues found — see job log

🏷️ Release Preview

The release banner is being designed! 🎨

Current: 4.6.3a1 → Next: 4.7.0a1

Signal	Value
Label	(none)
PR title	feat: optional admin panel launcher (--with-admin)
Bump	minor

✅ PR title follows conventional commit format.

---

🚀 Release Channel Compatibility

Predicted next version: 4.7.0a1

Channel	Status	Note	Current Constraint
Stable	⚪	Not in channel	-
Testing	✅	Compatible	hivemind-core>=4.0.0,<5.0.0
Alpha	✅	Compatible	hivemind-core>=4.6.3a1

⚖️ License Check

Checking the paperwork! Everything seems in order. 📂

✅ No license violations found.

Policy: Apache 2.0 (universal donor). StrongCopyleft / NetworkCopyleft / WeakCopyleft / Other / Error categories fail. MPL allowed.

🔨 Build Tests

Running the final assembly check. 🔧

✅ All versions pass

Python	Build	Install	Tests
3.10	✅	✅	✅
3.11	✅	✅	✅
3.12	✅	✅	✅
3.13	✅	✅	✅

📊 Coverage

Tracking the evolution of our test suite. 🐒

❌ 39.8% total coverage

Per-file coverage (9 files)

File	Coverage	Missing lines
hivemind_core/__main__.py	0.0%	62
hivemind_core/scripts.py	0.0%	410
hivemind_core/service.py	0.0%	87
hivemind_core/version.py	0.0%	5
hivemind_core/database.py	26.2%	48
hivemind_core/protocol.py	63.9%	268
hivemind_core/policy.py	77.1%	25
hivemind_core/config.py	81.2%	6
hivemind_core/__init__.py	100.0%	0

Full report: download the coverage-report artifact.

---

Coded with logic, delivered with care. 🧠