2 unstable releases
0.2.0 | Nov 21, 2023 |
---|---|
0.1.0 | Oct 4, 2022 |
#7 in #aries
26 downloads per month
Used in siera
100KB
1.5K
SLoC
Siera CLI
Powered by Hyperledger Aries and
Getting started | Roadmap | Contributing
Looking for more UI and less CLI? Try out the new Siera Desktop application.
Siera is the most convenient way for self-sovereign identity (SSI) developers to interact with SSI agents.
- Environments to easily manage configuration for multiple projects and agents
- Automations that you can perform against an agent
- Mock data so that you can focus on the important task of building your application instead of other foobar (coming soon 🚧)
If you are looking for more information about the concepts, example code and tutorials on how to use the CLI we recommend you check out our extensive docs.
Installation
Heres how to install Siera using the most popular package managers. For advanced installation options, binaries and troubleshooting we recommend checking out the installation guide.
macOS using Brew
brew tap animo/siera
brew install siera
Cargo install
cargo install --git https://github.com/animo/siera-cli
Manual build from source
git clone https://github.com/animo/siera-cli
cd siera-cli
# Run ONE of the following commands to build:
make build
cargo build --release
# Run ONE of the following commands to add install the siera into your PATH
make install
cargo install --path .
Getting started
In order to work with Siera an agent needs to be configured. With the following command you connect with our community agent and can access all the functionality.
siera configuration add --default
This command will set up the community agent. To set up your own agent or use our multi-tenant agent to get your own environment, see the set up guide.
If you are getting started with the tool we recommend enabling informational logs by passing the --verbose
(or -v
) flag.
To see all actions simply use the --help
or -h
flag or see the feature overview.
Roadmap
We intend to support multiple versions of the Aries agent. See the CLI help siera --help
for a list of actions we currently support.
Feature | Status | Description |
---|---|---|
Environments | ✅ | Support multiple environments. |
Connections | ✅ | Retrieve connections or create invitations. |
Schemas | ✅ | Retrieve or create schemas. |
Credentials | ✅ | Offer or propose credentials. |
ACA-Py 0.7.3 support | ✅ | ACA-Py 0.7.3 support. |
Verbosity | ✅ | Three verbosity levels and error messages. |
Automation: offer credential mocked | ✅ | Offer a mocked data credential through an automation. |
Community agent | ✅ | Default use with the Animo community agent. |
Multitenancy | ✅ | Use a personal agent environment with your personal token. |
Brew install | ✅ | Brew install. |
Proofs | ✅ | Proofs. |
Apt-get install | ✅ | Apt-get install. |
Chocolaty install | ✅ | Chocolaty install. |
Automation: offer credential custom | ✅ | Offer a custom data credential through an automation. |
Filters | 🚧 | Use filters to determine what output you want returned. |
Automation: definitions custom | ✅ | Create a schema + credential definition with custom data through an automation. |
Automation: proofs mock | 🚧 | Present proof with mock data through an automation. |
Automation: proofs custom | 🚧 | Present proof with custom data through an automation. |
Contributing
Is there something you'd like to fix or add to the CLI? Great! We 💗 community contributions. Get involved.
Dependencies
~4–23MB
~337K SLoC