1- # CommuneX
1+ # Torus CLI
2+
3+ The Torus CLI serves as an official SDK for the network, offering a streamlined and
4+ user-friendly experience. It is designed for simplicity and scalable
5+ development. To learn more [ visit docs] ( https://docs.torus.network/installation/setup-torus-cli )
6+
7+ ## Contents
28
39[ ![ License: MIT] ( https://img.shields.io/badge/License-MIT-yellow.svg )] ( https://opensource.org/licenses/MIT )
4- [ ![ Discord Chat] ( https://img.shields.io/badge/discord-join%20chat-blue.svg )] ( https://go.agicommies.org/commune-discord )
10+ [ ![ Discord Chat] ( https://img.shields.io/badge/discord-join%20chat-blue.svg )] ( https://discord.gg/W2H8Q6aE )
511[ ![ PyPI version] ( https://badge.fury.io/py/torus.svg )] ( https://pypi.org/project/torus/ )
612
7- - [ Why CommuneX ] ( #why- torus )
8- - [ Installation with ` pip ` ] ( #installation-with-pip )
9- - [ Installation with Nix ] ( #installation-with-nix )
10- - [ Features ] ( #features )
11- - [ Planned ] ( #planned )
12- - [ CLI Usage] ( #cli-usage )
13+ - [ Torus CLI ] ( #torus-cli )
14+ - [ Contents ] ( #contents )
15+ - [ Installation with ` pip ` ] ( #installation-with-pip )
16+ - [ Installation with Nix ] ( #installation-with-nix )
17+ - [ Features ] ( #features )
18+ - [ CLI Usage] ( #cli-usage )
1319 - [ Examples] ( #examples )
20+ - [ Retrieving Balance] ( #retrieving-balance )
21+ - [ Creating a Key] ( #creating-a-key )
22+ - [ Retrieving Key Info] ( #retrieving-key-info )
23+ - [ Listing Keys] ( #listing-keys )
24+ - [ List Keys With Balances] ( #list-keys-with-balances )
25+ - [ Retrieving Agent Information] ( #retrieving-agent-information )
26+ - [ Retrieving Global Parameters] ( #retrieving-global-parameters )
27+ - [ Retrieving Circulating Supply] ( #retrieving-circulating-supply )
1428 - [ Completions] ( #completions )
15- - [ Contributing] ( #contributing )
16- - [ Commune compatibility] ( #commune-compatibility )
17-
18- ## Why CommuneX
19-
20- CommuneX serves as an alternative library/SDK to the original [ Commune
21- Ai] ( https://github.com/commune-ai/commune ) codebase, offering a streamlined and
22- user-friendly experience. It is designed for simplicity and scalable
23- development. To learn more [ visit docs] ( https://docs.torus.ai/torus )
29+ - [ Contributing] ( #contributing )
2430
2531## Installation with ` pip `
2632
2733Requirements: Python 3.10+
2834
29- Install the ` torus ` Python package directly with ` pip ` :
35+ Install the ` torus-cli ` Python package directly with ` pip ` :
3036
3137``` sh
3238pip install torus
@@ -47,123 +53,112 @@ nix profile install .
4753
4854## Features
4955
50- - [x] Commands
51- - [x] Key management
52- - [x] Transfering and staking tokens
53- - [x] Module management
54- - [x] Client to interact with served modules
55- - [x] Module class and server
56- - [x] Governance participation
56+ The ` torus-cli ` offers a variety of features for token management and agent interaction:
5757
58- ### Planned
58+ - Commands for managing keys, tokens, and agents
59+ - Key management including creation and listing
60+ - Token operations such as transferring and staking
61+ - Agent management for registration, curation and updates
62+ - Participation in governance processes
5963
60- - [ ] Module API extraction and documentation generator
6164
6265## CLI Usage
6366
6467The CLI commands are structured as follows:
6568
6669``` sh
67- comx [OPTIONS] COMMAND [ARGS]
70+ torus-cli [OPTIONS] COMMAND [ARGS]
6871```
6972
7073There are six top-level subcommands:
7174
72- - ** balance** : transfer, stake, unstake and showing balance operations
73- - ** key** : creating, saving (AKA regenerating), listing and showing balance
74- operations
75- - ** module** : info, list, register, serve, update
76- - ** network** : block, parameters, proposals / proposing, voting operations
77- - ** subnet** : info, list, update
78- - ** misc** : apr, circulating supply
75+ - ** balance** : Manage token balances and staking.
76+ - ** key** : Handle key creation and management.
77+ - ** agent** : Manage information and operations related to agents.
78+ - ** network** : Interact with network operations like block and proposal management.
79+ - ** misc** : Access miscellaneous information such as APR and circulating supply.
7980
8081``` sh
81- comx subcommand [OPTIONS] COMMAND [ARGS]...
82+ torus-cli subcommand [OPTIONS] COMMAND [ARGS]...
8283```
8384
84- ### Examples
85+ ## Examples
8586
86- #### Retrieving Balance
87+ ### Retrieving Balance
8788
8889``` sh
8990# Show staked, free and total balance.
90- comx balance show 5FgfC2DY4yreEWEughz46RZYQ8oBhHVqD9fVq6gV89E6z4Ea
91+ torus-cli balance show 5FgfC2DY4yreEWEughz46RZYQ8oBhHVqD9fVq6gV89E6z4Ea
9192```
9293
93- #### Creating a Key
94+ ### Creating a Key
9495
9596``` sh
96- comx key create key_name
97+ torus-cli key create key_name
9798```
9899
99- #### Retrieving Key Info
100+ ### Retrieving Key Info
100101
101102``` sh
102- comx key show key_name
103+ torus-cli key show key_name
103104
104- # Add the `--show-private` flag to show sentitive fields like private key.
105- comx key show key_name --show-private
105+ # Add the `--show-private` flag to show sensitive fields like private key.
106+ torus-cli key show key_name --show-private
106107```
107108
108- #### Listing Keys
109+ ### Listing Keys
109110
110111``` sh
111112# Lists the names and addresses of keys stored on disk.
112- comx key list
113+ torus-cli key list
113114```
114115
115- #### List Keys With Balances
116+ ### List Keys With Balances
116117
117118``` sh
118119# Lists keys stored on disk with their balance (free, staked and total).
119- comx key balances
120+ torus-cli key balances
120121```
121122
122- #### Retrieving Module Information
123+ ### Retrieving Agent Information
123124
124125``` sh
125- # Note that the module has to be registered on the network.
126- comx module info vali::calc [--balance]
126+ # Note that the agent has to be registered on the network.
127+ torus-cli agent info vali::calc [--balance]
127128```
128129
129- #### Retrieving Global Parameters
130+ ### Retrieving Global Parameters
130131
131132``` sh
132- comx network params
133+ torus-cli network params
133134```
134135
135- #### Retrieving Subnet Parameters
136-
137- ``` sh
138- comx subnet list
139- ```
140-
141- #### Retrieving Circulating Supply
136+ ### Retrieving Circulating Supply
142137
143138``` sh
144139# Gets all tokens then were ever emitted minus burned tokens.
145- comx misc circulating-supply
140+ torus-cli misc circulating-supply
146141```
147142
148- ### Completions
143+ ## Completions
149144
150145You can enable completions for your shell by running:
151146
152147``` sh
153148# On bash
154- comx --install-completion bash
149+ torus-cli --install-completion bash
155150# On zsh
156- comx --install-completion zsh
151+ torus-cli --install-completion zsh
157152```
158153
159154## Contributing
160155
161156Bug reports and pull requests and other forms of contribution are welcomed and
162- encouraged! :)
157+ encouraged! :)
163158
164159To report a bug or request a feature, please [ open an issue on GitHub] .
165160
166- If you have any questions, feel free to ask on the [ CommuneX Discord channel] or
161+ If you have any questions, feel free to ask on the [ CLI Discord channel] or
167162post on our [ GitHub discussions page] .
168163
169164To contribute to the codebase, using Poetry you can install the development dependencies with:
@@ -172,20 +167,11 @@ To contribute to the codebase, using Poetry you can install the development depe
172167poetry install --with dev
173168```
174169
175- it can [ require some enviroment-specific binaries to be installed] [ ruff-installation ]
176-
177- ## Commune compatibility
178-
179- Yes, ` torus ` is compatible with the ` commune ` library/CLI. However, there are
180- important considerations to note. ` torus ` verifies the integrity of your
181- keys, which means that mixing certain types of keys is not permissible.
182- Specifically, if you possess node keys or other similar types that are not
183- designed to receive tokens, you to relocate them outside of the key
184- directory.
170+ it can [ require some environment-specific binaries to be installed] [ ruff-installation ]
185171
186172---
187173
188- [ open an issue on GitHub ] : https://github.com/agicommies /torus/issues/new/choose
189- [ CommuneX Discord channel] : https://go.agicommies .org/torus-channel
190- [ GitHub discussions page ] : https://github.com/agicommies /torus/discussions
174+ [ open an issue on GitHub ] : https://github.com/renlabs-dev /torus-cli /issues/new/choose
175+ [ torus-cli Discord channel] : https://go.renlabs-dev .org/torus-cli -channel
176+ [ GitHub discussions page ] : https://github.com/renlabs-dev /torus-cli /discussions
191177[ ruff-installation ] : https://docs.astral.sh/ruff/installation/
0 commit comments