Hyp
[ Demo Video | Installation | Usage | Overview | Website ]
A CLI for peer-to-peer file sharing (and more) using the Hypercore Protocol.
Installation
Requires nodejs 14+
npm install -g @hyperspace/cli
Usage
Command overview:
Usage: hyp <command> [opts...]
General Commands:
hyp info [urls...] - Show information about one (or more) hypers.
hyp seed {urls...} - Download and make hyper data available to the network.
hyp unseed {urls...} - Stop making hyper data available to the network.
hyp create {drive|bee} - Create a new hyperdrive or hyperbee.
hyp beam {pass_phrase} - Send a stream of data over the network.
Hyperdrive Commands:
hyp drive ls {url} - List the entries of the given hyperdrive URL.
hyp drive mkdir {url} - Create a new directory at the given hyperdrive URL.
hyp drive rmdir {url} - Remove a directory at the given hyperdrive URL.
hyp drive cat {url} - Output the content of the given hyperdrive URL.
hyp drive put {url} [content] - Write a file at the given hyperdrive URL.
hyp drive rm {url} - Remove a file or (if --recursive) a folder at the given hyperdrive URL.
hyp drive diff {source_path_or_url} {target_path_or_url} - Compare two folders in your local filesystem or in hyperdrives. Can optionally "commit" the difference.
hyp drive sync {source_path_or_url} [target_path_or_url] - Continuously sync changes between two folders in your local filesystem or in hyperdrives.
hyp drive http {url} - Host a hyperdrive as using HTTP on the localhost.
Hyperbee Commands:
hyp bee ls {url} - List the entries of the given hyperbee URL.
hyp bee get {url} - Get the value of an entry of the given hyperbee URL.
hyp bee put {url} [value] - Set the value of an entry of the given hyperbee URL.
hyp bee del {url} - Delete an entry of the given hyperbee URL.
Daemon Commands:
hyp daemon status - Check the status of the hyperspace daemon.
hyp daemon start - Start the hyperspace daemon.
hyp daemon stop - Stop the hyperspace and mirroring daemons if active.
Aliases:
hyp sync -> hyp drive sync
hyp diff -> hyp drive diff
hyp ls -> hyp drive ls
hyp cat -> hyp drive cat
hyp put -> hyp drive put
Overview
The Hypercore Protocol is a peer-to-peer network for sharing files and data. This command-line provides a convenient set of tools for accessing the network.
There are two common kinds of "Hypercores":
- Hyperdrive A folder containing files.
- Hyperbee A key-value database (similar to leveldb).
All data has a URL which starts with hyper://. A URL will look like this:
hyper://515bbbc1db2139ef27b6c45dfa418c8be6a1dec16823ea7cb9e61af8d060049e/
You use these URLs to access the hyper data over the peer-to-peer network. For example:
hyp ls hyper://515bbbc1db2139ef27b6c45dfa418c8be6a1dec16823ea7cb9e61af8d060049e/
hyp cat hyper://515bbbc1db2139ef27b6c45dfa418c8be6a1dec16823ea7cb9e61af8d060049e/file.txt
cat diagram.png | hyp put 515bbbc1db2139ef27b6c45dfa418c8be6a1dec16823ea7cb9e61af8d060049e/diagram.png
You can create a new hyperdrive or hyperbee using the create commands:
hyp create drive
You can then seed the hyper (or seed a hyper created by somebody else) using the seed command:
hyp seed hyper://515bbbc1db2139ef27b6c45dfa418c8be6a1dec16823ea7cb9e61af8d060049e/
To see what hypers you are currently seeding, run info:
hyp info
Documentation
The website documentation have a lot of useful guides:
32 Dec 26, 2022
121 Oct 3, 2022
6 Nov 11, 2022
343 Dec 1, 2022
2 Feb 5, 2022
14.7k Dec 29, 2022
3.6k Dec 30, 2022
3.5k Dec 30, 2022
619 Dec 26, 2022
422 Nov 19, 2022
262 Nov 21, 2022
8k Jan 4, 2023
7 Jun 6, 2021
21 Dec 13, 2022
26 Jan 10, 2022
1 Dec 25, 2021
34 Jan 3, 2023
9 Nov 17, 2022