This release is a pre-release and may not be stable for production use.
HiveMind Admin Panel
A web-based administration panel for HiveMind-core, a FastAPI backend and single-page web UI for running and managing a HiveMind hub.
It ships as a standalone, optional package. It is the single launcher. It starts
hivemind-core in-process and serves the admin UI, so you run one command and
get a hub plus a place to administer it.
Features
- Clients & access keys: create, list, update, and revoke keys. Run bulk operations, reveal credentials, and use QR pairing for one-tap satellite onboarding.
- Per-client ACLs: allow message types, skills, and intents. Toggle escalate and propagate flags and admin flags, and apply ACL templates.
- Test Chat: an in-browser chat that impersonates any client, talking through the hub to whatever agent is behind it. It exercises the real path: the client's ACL, routing, and the agent's reply.
- Chat bridges: provision a ready client for a Matrix, Twitch, Mattermost, DeltaChat, or HackChat bridge, and see it labelled in the topology.
- Security: a forced first-run password change, a dashboard security
self-check, session tokens,
admin/operatorroles, and an audit trail. - Monitor: live metrics, an SSE event feed, the hub log tail, and the audit log.
- Topology: an interactive mesh graph (hub and satellites) with online status.
- Personas & agents: manage personas (modern
handlersschema), run a multi-turn memory-aware test chat, use configurable, installable memory modules, and get pre-activation validation. Browse the agent-engine taxonomy. - Plugin lifecycle: install, upgrade, and uninstall plugins (with an active-module guard) and see installed versions.
- Plugin presets: named, reusable
{module, config}sets for STT, TTS, WW, VAD, agent, and network plugins (local plugin or OVOS-server pointer). Author a preset once, test it, and select it. - Config safety: the panel snapshots
server.jsonbefore every change. Diff it and revert with one click from the Operations page. - OVOS servers: register and health-check external persona, STT, TTS, and translate servers.
- Plugins & databases: discover and install network, agent, database, and OVOS plugins (via uv). Use JSON, SQLite, or Redis backends with profiles, tests, and migration.
- Ops: back up and restore, edit the admission policy, and manage self-signed TLS certs.
Install
pip install hivemind-admin-panel
Quickstart
hivemind-admin-panel is the single launcher. It starts hivemind-core in-process
and serves the admin UI. You do not run hivemind-core separately.
hivemind-admin-panel --host 127.0.0.1 --port 8100
# open http://127.0.0.1:8100 (first login: admin / admin — you'll be forced to change it)
Panel only (manage on-disk config/database without starting a hub):
hivemind-admin-panel --no-core --host 127.0.0.1 --port 8100
Docker Compose (hivemind-core + admin panel + Redis):
docker compose up --build
# open http://127.0.0.1:8100 (edit docker/server.json to set admin_pass first)
The hub bridges to an agent backend (an OVOS messagebus by default) for answers. Without one reachable, the panel stays up and tells you the satellite listener is not ready. See Troubleshooting.
Screenshots
| Test Chat (impersonate a client) | Mesh topology |
|---|---|
 |
 |
| Forced first-run security | Provision a chat bridge |
|---|---|
 |
 |
Credentials
The panel uses HTTP Basic or bearer auth, read from ~/.config/hivemind-core/server.json
(admin_user and admin_pass, both default to admin). On first login with the
default password, the panel forces a change and stores it hashed (PBKDF2). The panel
can install packages and migrate databases, so keep it on 127.0.0.1 or behind a
trusted reverse proxy. See Security.
Documentation
Full docs live in docs/: a path from zero to a working setup for newcomers, and a
reference track for advanced developers.
Newcomers: Concepts · Getting started · Tutorial · Glossary · Troubleshooting
Operate: Running · CLI · Configuration · Operations · Security · Deployment · OVOS servers · Chat bridges · Test Chat · Plugin presets
Develop: Architecture · Extending · API reference · Development · Roadmap
Relationship to HiveMind-core
The panel was extracted from core so it has its own release cadence and stays an
optional, separately-deployable admin plane. It is the launcher: it starts a
hivemind-core in-process and keeps a live reference to it, so core needs no
admin-specific code. See docs/architecture.md.
License
Apache-2.0. See LICENSE.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file hivemind_admin_panel-0.2.1a1.tar.gz.
File metadata
- Download URL: hivemind_admin_panel-0.2.1a1.tar.gz
- Upload date:
- Size: 201.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
31e635eee45feb6aa743c3209d97b297645aa93cd76e97391615ad839199aba5
|
|
| MD5 |
c574e8f060ae8495e8ebd1ed86587d5a
|
|
| BLAKE2b-256 |
a10c869b15aca2f706ba23a47d4aef1b3491230012345ae124c759a4e71d9066
|
File details
Details for the file hivemind_admin_panel-0.2.1a1-py3-none-any.whl.
File metadata
- Download URL: hivemind_admin_panel-0.2.1a1-py3-none-any.whl
- Upload date:
- Size: 170.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d72f71a1d786f98a27e9ad8dbc92d5babeb65a91d4a1ed1de81aec8abf7f3aaf
|
|
| MD5 |
e85b883c93f4797ae6c3e7bfd29dd785
|
|
| BLAKE2b-256 |
66f90e796e7781bc024122b82eee5496fbb5de4b6cd882f9259018555bb683bc
|
