Neon Mana
Neon Mana (Messagebus Application for Neon AI) provides tools for interacting with the MessageBus.
Install the Mana utilities Python package with: pip install neon-mana-utils
The mana entrypoint is available to interact with a bus via CLI. Help is available via mana --help.
Configuration
The default behavior of Mana is to connect to the default core bus (ws://0.0.0.0:8181/core). The connection can be
configured for all mana commands via:
mana configure-messagebus --host "192.168.1.100" --port 18181
--hostspecifies the host URL or IP address--portspecifies the port theMessageBusis running on
Any unspecified arguments will use default values.
All configurations can be printed to the terminal with:
mana print-config
Monitoring
Mana can connect to a messagebus and log all Message objects sent on that bus.
mana tail-messagebus --format
--formatflag formats serialized messages printed to the shell
Filtering Messages by type
--include and --exclude arguments may be passed to include or exclude messages
with msg_type matching specified prefixes. Global filters may be specified in:
${XDG_CONFIG_HOME}/mana/filters.yml. An example filter file is included here:
include:
- recognizer_loop
exclude:
- "recognizer_loop:utterance"
The spec above would log any Messages that start with recognizer_loop, except
messages with type recognizer_loop:utterance.
Monitoring other MessageBusses
--host, --port, --route, and --ssl may be specified to monitor a different
messagebus without changing the configured bus that is used for other commands. A
common use case would be to monitor the GUI bus while interacting with the core bus.
Sending Messages
There are several commands available to interact with a connected Core.
send-message
Send an arbitrary Message over the MessageBus. The specified file should be a json or yaml
serialized message. --response may optionally define a response message type to wait for and print to the terminal.
Basic Commands
These are commands supported by Mycroft and all derivative cores; they replicate some of the commands originally found in mycroft-core/bin.
listen
Send a mycroft.mic.listen Message.
stop
Send a mycroft.stop Message.
say-to
Send a recognizer_loop:utterance Message to skills for processing. This sends a minimal message that is
not sufficient for testing user profiles or multi-user cores.
speak
Send a speak Message to TTS for generation and playback
Messagebus API
These commands are currently specified for neon-core only and are not supported
by other cores. Work is ongoing to standardize these entrypoints across projects.
get-stt
Send a neon.get_stt Message and print the returned Message with transcriptions.
This will only work under NeonCore.
get-tts
Send a neon.get_tts Message and print the returned Message with a path to generated TTS.
This will only work under NeonCore.
get-response
Send a recognizer_loop:utterance Message with the appropriate context to return a klat.shout response.
This will only work under NeonCore and will likely be refactored to reflect NeonCore changes.
Metadata
Release files for neon-mana-utils 0.3.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| neon-mana-utils-0.3.1.tar.gz | 12.7 kB | Without provenance | Details for neon-mana-utils-0.3.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| neon_mana_utils-0.3.1-py3-none-any.whl | Python 3 | none | any | Details for neon_mana_utils-0.3.1-py3-none-any.whl |
Total release size: 35.8 kB
Release files / neon-mana-utils-0.3.1.tar.gz
| Download URL | neon-mana-utils-0.3.1.tar.gz |
|---|---|
| Size | 12.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
87b11486748e255934d0b4a988b9a399d1c0bc92dca31c477c9350f55baa7cf8
|
|
BLAKE2b-256 checksum How to use checksums |
f9e6d890ea48c30fa579ba5ca870a9beae55c57711966a60443348b1dd6b7ac2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Release files / neon_mana_utils-0.3.1-py3-none-any.whl
| Download URL | neon_mana_utils-0.3.1-py3-none-any.whl |
|---|---|
| Size | 23.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f7cfed0762abb930cc6226b402bd97dcf08870c00c80718a72fc7d434e6776eb
|
|
BLAKE2b-256 checksum How to use checksums |
68180a61e72e8ef2587dc2711284b32dbf4e8597c9f7fc11d4fe2f0fef4398af
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Security for neon-mana-utils 0.3.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.