Skip to main content
Python Software Foundation 20th Year Anniversary Fundraiser  Donate today!

A currency trading ledger in Python

Project description

Tallywallet helps Engineers understand Money and Banking.

You can use it to create economic simulations, or to enable your applications with currency exchange and accounting features.

This package

Tallywallet is a very young project. This package implements the following:


  • Functions to work with Promissory Notes
  • A Ledger class for double-entry accounting
  • An Exchange class to enable currency trading
  • Pre-hoc calculation of exchange rate gains on currency trading accounts
  • Evaluation of the Fundamental Accounting Equation to verify balanced accounts
  • A text format for saving Ledgers to file


  • A how-to on loans, discounting, and amortization
  • A tutorial on how to achieve foreign currency exchange in Python code
  • An example of a macroeconomic monetary circuit simulation


Tallywallet requires Python 3. It uses setuptools for installation, but normally it has no external runtime dependencies.

Tallywallet comes with unit tests. To run them all requires the RSON package.

Quick start

Clone the git repository:

git clone
cd tallywallet-common

Install the package and its dependencies:

python3 -m pip install .[docbuild,test]

Run the tests:

python3 -m unittest discover tallywallet

Consult the documentation:

    sphinx_build tallywallet/common/doc tallywallet/common/doc/html
firefox tallywallet/common/doc/html/index.html


Tallywallet’s mission is to provide a validated Pythonic framework for money trading and economic applications.

It is developed by a private individual but released to the public under the GNU Affero General Public License.

The API may change significantly as the project proceeds. At this early stage, you should only use the latest release, which may not be compatible with previous versions.

Can you help?

  • If you’ve spotted a bug in Tallywallet, please let us know so we can fix it.
  • If you think Tallywallet lacks a feature, you can help drive development by describing your Use Case.

In either event, please leave a message on the project’s message board.

Author:D Haynes
Copyright:2014 Thuswise Ltd

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for tallywallet-common, version 0.10.0
Filename, size File type Python version Upload date Hashes
Filename, size tallywallet-common-0.10.0.tar.gz (241.1 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page