Local Portfolio Manager

Summarize transactions in securities into a portfolio report tool.

Available features:

• Holdings overview: a table of your current holdings, and the market value of the positions.
• A transaction list: merge data from multiple sources into one transaction list.
• A transaction chart: show historical price data along with markers for purchases and divestments.
• Profit- and loss statement: show the historical result from your transactions.

What exactly is this?

It's a web app running on your computer.

But why

I've been looking for a library where I can download a set of transactions from my broker and pension fund manager use the merged data for analysis. When I couldn't find one, I decided to build it instead.

Cloud storage? No.

Your data is stored locally. The only thing cloud is that the library allows you to fetch market data from the Internet.

Screenshots from app

Click the images to view a larger version.

Portfolio overview

Transaction list

Income statement

Installing

Choose one of the options below. I'm personally using (1).

(1) Running in VS Code

• Clone the library from GitHub: git clone https://github.com/ggravlingen/pypmanager.git
• Install Docker Desktop on your computer.
• Install VSCode from Microsoft.
• Install the Dev Containers extension.
• Open the library in VSCode and choose the option to open the folder in a container.
• Run the install script by typing ./scipt/install.sh.
• Start the server in VSCode by clicking Run and Debug and then Pypmanager server.
• Browse to the transaction list on http://localhost:8001/#/transaction.

(2) Building a Docker image from the source and Running as a stand-alone Docker service

• Build the Docker image file: docker build . --tag pypmanager:latest.
• Spin up a container and mount your data folders: docker run -p 8001:8001 -v ./data:/code/app/data pypmanager:latest.
• Browse to the transaction list on http://localhost:8001/#/transaction.

(3) Running a pre-build docker

• Fetch the docker image docker pull ghcr.io/ggravlingen/pypmanager:2024.12.4, where 2024.12.4 is the version you want to install.
• Spin up a container and mount your data folders: docker run -p 8001:8001 -v ./data:/code/app/data pypmanager:2024.12.4.
• Browse to the transaction list on http://localhost:8001/#/transaction.

How do add transactions

Your own data goes into the folder data/transactions. If you make contributions to this library, no files from the data folder should be committed to the library as it contains your own, private, data.

Market data (end-of-day prices on funds and equities)

This library is capable of calculating the current value of your portfolio. For this, we need end-of-day prices on funds and equities (market data).

I have provided a few data sources built-in. Download this data using make load-data.

Configuration is done by appending pypmanager/configuration/market_data.yaml with the securities you want to download data for.

Currently, there is support for loading data from the following sites:

• Morningstar
• The Financial Times
• Svenska Handelsbanken

Please feel free to subsmit your own data source.