hcagent

Extends Holochain to allow multiple agents on the same machine.

Introduction

hcagent is a complete set of tools that enables a machine to run multiple agents.

Usecases

Allows a user to maintain multiple idententies that are totally isolated from each other.
Allows a user to manage other people's apps while preserving their identity and own access. 2.2 think of a parent and children. 2.3 think of a teacher and students.

Examples

You can do the following things:

$ hcagent init joe

$ hcagent as joe hcadmin join ~/thatapp myapp

$ hcagent as joe hcd myapp

$ hcagent info joe

TBC

Installation

You can directly call hcagent script located in bin/: $ /path/to/hcagent/bin/hcagent list

Or set it up to run it from anywhere: $ hcagent list

You can either add the bin/ directory to $PATH: export PATH="${PATH}:/path/to/hcagent/bin" (Some help here http://hmgaudecker.github.io/econ-python-environment/paths.html)

Or, add a symlink to bin/hcagent in a directory that is in the $PATH: $ ln -s /path/to/hcagent/bin/hcagent /usr/local/bin

Run your app on two browser tabs that simlulate two users

You've written the code and want to see if the app works for two users!

For that, we need to run two totally seperate instances of the app. Those instances are called a node or an agent.

To make it clean and simple, we will have two terminal windows open and run commands for every agent in its own terminal.

Bite 1

Let's create two agents first and call them a1 and a2:

Terminal 1: $ hcagent init Jane

Terminal 2: $ hcagent init Alexar

Bite 2

Now, let's install our app for both of them:

Terminal 1: $ hcagent as Jane hcadmin join ~/dev/mydapp/ mydapp

Terminal 1: $ hcagent as Alexar hcadmin join ~/dev/mydapp/ mydapp

Bite 3

Ok, ready to run the app?

Before we do so, we need to start the Bootstrap Server (BS).

We need to keep Bootstrap Server running, so let's run it in a separete terminal:

Terminal 3: $ bs --port=5001

bs is a standard Holochain command. hcagent is using 5001 as the BS port.

Bite 4

Finally it's time to run our apps, or better to say to get our agents run their node!

Terminal 1: $ hcagent as Jane hcd mydapp 3141

Terminal 1: $ hcagent as Alexar hcd mydapp 3142

Cool, had fun? More journeyes to come, stay tuned!

Tip: Did you know you can Star and Watch a project on Github at the same time?!

Manual, Contribution, etc

They're all in the oven, in the meantime, enjoy dapping with Holochain with the above entrees!

History

This project has evolved from hctools project. https://github.com/pendashteh/hctools

pendashteh/hcagent