Skip to content

0.0.1-pre-alpha

Pre-release
Pre-release
Compare
Choose a tag to compare
@lucksus lucksus released this 22 Aug 20:08
· 118 commits to master since this release

Holoscape 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