Skip to content
[Released] A Python/HTML Wallet based upon Tornado framework
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
doc fix doc Dec 14, 2018
wallet Update messages.po ( Jul 14, 2019
.gitignore fix gitignore May 26, 2019 Bump version Jun 13, 2019
LICENSE Initial commit May 15, 2018 Bump version Jun 13, 2019
requirements.txt Add maxa command line param Jul 14, 2019 Part of BIS URL handling Dec 17, 2018 Update credits Dec 21, 2018


A Python/HTML Wallet based upon the Tornado framework.

First stable release, still work ongoing, but useable and nice looking!

First stable version 0.1.19

Goal is to re-use the existing python code for behind the scene heavy lifting, but leverage HTML/JS flexibility for GUI.

First release has following features

  • manage wallets (several addresses)
  • auto connect to an available wallet server
  • check balance and transactions
  • request BIS payments
  • Send simple BIS transactions
  • network status
  • encrypt and decrypt off chain messages
  • spend protection
  • support for crystals (plugins, like dApps running in the wallet)

Installation from release

See Release tab for info/installer and OS Specific FAQ.

Installation from source

pip3 install -r requirements.txt

Pycryptodomex is used and may need extra install on your machine.

An auto-installer will be provided with first beta version.


You may have to install xcode compiler:

xcode-select --install

then pip3 install -r requirements.txt



then pip3 install -r requirements.txt


If you have no wallet yet, you'll be redirected to the wallet load page.

Possible command line switches:

  • --verbose --debug
  • --theme=themes/material Force a specific theme
  • --server=ip:port Force a specific walelt server (like

See the FAQ:

Wallet(s) location

Wallets and other potential private info are to be stored under a "bismuth-private" dir, under the user's own home directory.

The wallet prints that dir at start.
You should also find it on the wallet/load page:


  • Proof of concept (check)
  • Basic wallet functionality (check)
  • Auth (check)
  • Multiwallet (check)
  • Plugins (check: See crystals)
  • Allinone mobile app with embedded browser and python engine

The tech

  • Tornado web app
  • Templates / HTML Themes
  • JS
  • Embedded local webserver


Thanks to a great community effort, the wallet is available in several languages, see for list and credits.

Localized help

Help file / User guide is a WIP, see locale/en/

You can’t perform that action at this time.