Practical overview
When it fits
Use Bismuth when you need to operate or develop against its proof-of-work network, inspect ledger data through its documented API, or work on Bismuth-specific applications. Use regnet for the private development-chain workflow described by the project.
Who it is for
- Operators running a Bismuth blockchain node.
- Developers building Bismuth wallets, explorers or smart-contract applications.
- Contributors working on blockchain networking, mining or node components.
Documented uses
- Run a node that validates blocks and maintains a ledger.
- Read node, block, balance and transaction data through the REST API.
- Develop and test on the private regnet chain.
- Build Bismuth-specific wallets, explorers and smart-contract applications.
Requirements & limits
- The node quickstart requires Python 3.8 or later.
- The REST API is read-only and opt-in; it runs alongside the legacy socket protocol.
- Regnet has no peers and no real proof of work, so it serves a different purpose from mainnet.
- The repository recommends tagged releases for production because main may be ahead of what is network-validated.
- The repository specifies the GPL-3.0 license.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Install and start a Bismuth node
Set up the documented Python dependencies and start the node on mainnet.
Before you start
- Python 3.8 or later
- The Bismuth repository and its requirements-node.txt file
Steps
Install the node dependencies with pip3 install -r requirements-node.txt.
Start the mainnet node with python3 node.py.
Stop it cleanly with python3 node_stop.py.
Expected outcome
The documented quickstart starts a Bismuth mainnet node and provides a command to stop it cleanly.
Guide limitations
- The repository advises using a tagged release for production; main may be ahead of what is network-validated.
Start a private regnet development node
Configure and run the documented private, instantly mineable development chain.
Before you start
- Python 3.8 or later
- The Bismuth repository, including tests/config_custom.txt
Steps
Copy tests/config_custom.txt to config_custom.txt.
Start the development node with python3 node.py regnet2.
Expected outcome
The repository documents a regnet node with a REST API on port 3031 and a socket on port 3030.
Guide limitations
- Regnet is described as having no peers and no real proof of work; it is a development chain, not mainnet.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 6 October 2026
- Original website title
- hclivess/bismuth · Official homepage title · retained in its source language

