0.0.1-pre-alpha
Pre-releaseHoloscape pre-alpha 0.0.1
This is the first pre-alpha release of Holoscape.
Holo World
It includes everything needed as an MVP for the automatic install of hApps from bundles with just a few clicks.
But it also includes some pre-alpha bugs and UX quirks. Such as:
- If there is a conductor running already listening on the same ports, the started conductor will bail and Holoscape will wait during splash screen forever. If it doesn't start, make sure there is no old zombie conductor running. If that doesn't help, try starting it from command line so you can see the conductor output.
- If a bundle references resources via HTTP URI, Holoscape will download the file during install. If the network connection is flaky, it won't try again but show an error during install process.
- many more that are still unknown
This first release is for a first test roll-out, mainly targeted at Holochain/Holo teams.
Everybody is welcome to try this and provide feedback through issues, pull-request and all other means!
What to do with it?
Download the app bundle for your platform, unzip it and run the executable in there (double click Holoscape.app
on macOS or run the Holoscape
executable on Linux).
After the splash screen, there will be a Holoscape icon in the system tray.
Download the example hApp bundle personas-and-chat_bundle.zip
, and unzip it.
Choose "Install hApp..." from the Holoscape system tray menu. In the new window click browse and select the file chat.toml
from the unziped personas-and-chat_bundle.zip
. The dialog will now show the contents and immediately starts downloading the two DNAs which are referenced via HTTP link the bundle. Once the download is complete, the green "Install" button at the bottom will get enabled and you can install the bundle by clicking it. If this is your first time installing a DNA and agent, a popup will appear and ask for a passphrase. Remember the passphrase you enter as it will request the same again on next start up in order to unlock the agent keys. The whol install process will take about a 1 minute (mostly because hashing the password and creating and encrypting new keys takes some time).
After the install process is complete, you will find two new hApps in the "hApps" sub-menu of the Holoscape system tray menu:
- Basic Chat
- Personas
Both items can be clicked to show the according hApp UI.
Debugging with Holoscape
Click:
Holoscape Icon
|-> Conductor Run-Time
|-> Debug View
You see a list of all running instances.
- Click one of those names to expand
- Use the hApp while having the debug view opened
- You will see "Core actions" getting populated with little pills representing actions
- Click on one of those actions to see its parameters (like which zome function was called with a SignalZomeFunctionCall)
- Click "Source Chain" to see all the source chain entries of that instance