Skip to main content

SUCA Portfolio Tracker

A portfolio tracker for Indian families who manage several demat accounts: people, HUFs and companies, across brokers. It runs on your own Mac and opens in your browser.

Early preview. Versions 0.0.x install and run but have no portfolio features yet. They exist to prove installation and updates.

Your data stays on your Mac

  • The app listens only on 127.0.0.1, so other devices on your network cannot reach it, and it serves only the browser tab it opened for you.
  • Your statements, holdings and trades are never uploaded anywhere.
  • The only request it makes to the internet is an optional check, once per launch, for a newer version on pypi.org. That request sends no data. You can turn it off (see Options).

Requirements

An Apple Silicon Mac (M1 or later) running macOS 15 or later.

Install

Open Terminal and run these two commands. The first installs uv, a free Python installer. The second installs the app with its own copy of Python, so nothing else on your Mac changes.

curl -LsSf https://astral.sh/uv/install.sh | sh
uv tool install --managed-python --python 3.14 suca-pt

Then open a new Terminal window and start it:

suca-pt

Your browser opens the app. Leave the Terminal window open while you use it. To stop, click Quit in the app or press Ctrl-C in Terminal.

If suca-pt is not found, run uv tool update-shell and open a new window.

Update

When the app shows that a new version is available, quit it, then run:

uv tool upgrade suca-pt

Your data is kept.

Options

Command What it does
suca-pt --no-browser Print the address instead of opening the browser
suca-pt --port 8765 Use a fixed port instead of a free one
suca-pt --self-check Check that the app's components work on this Mac (prints no personal data)
suca-pt --check-update Check for a new version and exit
suca-pt --no-update-check Skip the update check this time
SUCA_PT_NO_UPDATE_CHECK=1 Skip it always (set in your shell profile)
suca-pt --version Show the installed version

Uninstall

uv tool uninstall suca-pt

That removes the app. Your data stays in ~/Library/Application Support/suca-pt. Delete that folder to remove it too.

Not advice

SUCA Portfolio Tracker reports what you hold and what it has earned. It does not recommend what to buy or sell.

Licence

© SUCA Analytics. All rights reserved. Free to use. Not open source.

Metadata

Release files for suca-pt 0.0.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for suca-pt 0.0.3
File Interpreter ABI Platform
suca_pt-0.0.3-py3-none-any.whl Python 3 none any Details

Release files / suca_pt-0.0.3-py3-none-any.whl

Download URL suca_pt-0.0.3-py3-none-any.whl
Size 20.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
3caae425e1090fa88796cdb782f6e32db97e2de9656cb391aec7251162f1ffb2
BLAKE2b-256 checksum
How to use checksums
88b1b35522ff785e747a308875a540339924b85b358f08dccc73e8c113cf1538
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release history Release notifications | RSS feed

This release

0.0.3 This release

1 release file

0.0.2

1 release file

0.0.1

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page