Skip to main content

Portfolio tools for GnuCash

Project description

# gnucash-portfolio

A collection of tools for managing an investment portfolio in GnuCash

User-oriented documentation is at

## Introduction

The purpose of the project is to provide tools that help in managing an investment portfolio in a GnuCash book. The code is written in Python.

## Development Environment

The development environment should include the following:

  • Python IDE (vscode or pycharm)
  • Python 3.6
  • node + npm

All the libraries are listed in requirements.txt.

## Set-Up

To install the required development and runtime dependencies, run

` pip install -r requirements.txt `

in the root and app directory since requirements.txt is in the project root.

The local/development versions of any library can be registered with

pip install -e <path>


pip install -e .

### Configuration

Go to config directory and copy the config.json.template file into config.json. Adjust any values as needed. This file can also be edited by going to the Settings option in the web app (webgui).

## Testing

See tests directory and documentation and tests there. Simply run


to run all tests.

### Lint

pylint can be used to check for errors. You can check the code by doing the following:

  • run utilslint_app.cmd from project root directory,
  • run lint tasks from vscode,
  • run pylint gnucash_portfolio to check the library.

Pay attention to the Error and Fatal lines. See utils/lint_app.cmd script for coloring output.

Ref: [PyLint Output](

# Reports

An approach using gnucash_utilities project is found in the /reports directory.

The basic idea here is to have GnuCash open a custom report, which runs a Python script, which generates an HTML output. Gnucash_utilities project provides utilities that generate the Scheme links in the user profile directory. You need to create the Python scripts, which return the HTML output generated with Jinja templates (or any other).

This approach has been abandoned due to the performance benefit of using the web app directly for all data input and output.

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 gnucash-portfolio, version 1.6.2
Filename, size File type Python version Upload date Hashes
Filename, size gnucash_portfolio-1.6.2-py3-none-any.whl (53.7 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size gnucash_portfolio-1.6.2.tar.gz (31.3 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page