Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/holochain-apps/emergence
Holochain hApp for distributed event coordination
https://github.com/holochain-apps/emergence
Last synced: 3 months ago
JSON representation
Holochain hApp for distributed event coordination
- Host: GitHub
- URL: https://github.com/holochain-apps/emergence
- Owner: holochain-apps
- Created: 2023-04-05T18:16:09.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-04-12T17:36:09.000Z (10 months ago)
- Last Synced: 2024-04-14T00:46:42.737Z (10 months ago)
- Language: Svelte
- Size: 6.78 MB
- Stars: 21
- Watchers: 5
- Forks: 0
- Open Issues: 28
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-weave - holochain-apps/emergence - apps/emergence) | [@zippy](https://github.com/zippy), [@brodeur](https://github.com/brodeur), [@mattyg](https://github.com/mattyg), [@starpause](https://github.com/starpause), [@jost-s](https://github.com/jost-s), [@steveej](https://github.com/steveej), [@unusedaccount](https://github.com/unusedaccount) | (Happs)
- awesome-weave - holochain-apps/emergence - apps/emergence) | [@zippy](https://github.com/zippy), [@brodeur](https://github.com/brodeur), [@mattyg](https://github.com/mattyg), [@starpause](https://github.com/starpause), [@jost-s](https://github.com/jost-s), [@steveej](https://github.com/steveej), [@unusedaccount](https://github.com/unusedaccount) | (Happs)
README
# Emergence
## Environment Setup
> PREREQUISITE: set up the [holochain development environment](https://developer.holochain.org/docs/install/).
Outside of nix shell you will need rust installed:
https://www.rust-lang.org/tools/install or https://rustup.rs/
Enter the nix shell by running this in the root folder of the repository:
```bash
nix develop
npm install
```
**Run all the other instructions in this README from inside this nix-shell, otherwise they won't work**.
## Running 2 agents
```bash
npm start
```
This will create a network of 2 nodes connected to each other and their respective UIs.
It will also bring up the Holochain Playground for advanced introspection of the conductors.
## Running solo dev environment
```bash
npm run dev
```
This will not launch a UI, you will have to open a browser window and navigate to the Local address provided by VITE. It can take a moment for the UI to come up after visiting the URL, let it load.
## Running the backend tests
```bash
npm test
```
## Bootstrapping a network
Create a custom network of nodes connected to each other and their respective UIs with:
```bash
AGENTS=3 npm run network
```
Substitute the "3" for the number of nodes that you want to bootstrap in your network.
This will also bring up the Holochain Playground for advanced introspection of the conductors.
## Packaging
To package the web happ:
``` bash
npm run package
```
You'll have the `emergence.webhapp` in `workdir`. This is what you should distribute so that the Holochain Launcher can install it.
You will also have its subcomponent `emergence.happ` in the same folder`.
## Documentation
This repository is using these tools:
- [NPM Workspaces](https://docs.npmjs.com/cli/v7/using-npm/workspaces/): npm v7's built-in monorepo capabilities.
- [hc](https://github.com/holochain/holochain/tree/develop/crates/hc): Holochain CLI to easily manage Holochain development instances.
- [@holochain/tryorama](https://www.npmjs.com/package/@holochain/tryorama): test framework.
- [@holochain/client](https://www.npmjs.com/package/@holochain/client): client library to connect to Holochain from the UI.
- [@holochain-playground/cli](https://www.npmjs.com/package/@holochain-playground/cli): introspection tooling to understand what's going on in the Holochain nodes.