Practical overview
When it fits
Use it for a hands-on local tutorial when you want to see a simple blockchain flow across a web interface and one or more Python nodes.
Who it is for
- Learners exploring blockchain concepts through a working Python example.
- Developers experimenting with local nodes, transaction posting, mining and chain synchronization.
Documented uses
- Post messages as transactions and request that a node mine them.
- Register additional nodes and observe chain synchronization.
- Inspect a node’s chain through the documented `/chain` endpoint.
- Change which node the frontend connects to by editing `CONNECTED_NODE_ADDRESS` in `views.py`.
Requirements & limits
The repository is publicly visible and the README provides clone and local setup instructions. No license is listed in the supplied repository metadata.
- The project separates the node server from the web application, which the README starts in separate terminal sessions.
- The documented multi-node example uses local ports and cURL registration requests.
- The README provides Windows-specific startup commands alongside shell instructions.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Set up the app and start a local node
Install the project dependencies, start one blockchain node, and launch the web application.
Before you start
- A local Python environment with pip.
- A terminal; the README includes separate command examples for Windows.
Steps
Clone the repository and change into its directory.
Install dependencies with the command below.
pip install -r requirements.txtSet
FLASK_APP=node_server.pyand start the node withflask run --port 8000.In a separate terminal session, run the command below.
python run_app.py
Expected outcome
The README says the application should be available at http://localhost:5000, with a node running on port 8000.
Guide limitations
- The guide documents local startup; it does not describe production deployment.
Register local nodes and inspect synchronized chains
Connect additional node servers to a node on port 8000 and inspect their chain data.
Before you start
- The project dependencies installed.
- A node server running on port 8000 and additional node servers on ports 8001 and 8002.
- cURL for the documented registration and chain-inspection requests.
Steps
Start node servers on ports 8000, 8001 and 8002 with
FLASK_APP=node_server.py.POST to each additional node’s
/register_withendpoint, providing{"node_address": "http://127.0.0.1:8000"}as JSON.Inspect the nodes with GET requests to
http://localhost:8001/chainandhttp://localhost:8002/chain.
Expected outcome
The README says registration makes the nodes aware of one another and synchronizes the newer nodes with the node on port 8000, allowing them to participate in mining.
Guide limitations
- The example covers local nodes and does not describe deployment across external hosts.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 17 October 2026
- Original website title
- satwikkansal/python_blockchain_app · Official homepage title · retained in its source language