What is this?
A self-hosted, open-source crypto portfolio tracker meant to import transactions from CSV or exchange APIs and calculate real-time profit and loss while keeping data on your machine. The Quick Start, however, is not a normal install (see below).
A self-hosted, open-source crypto portfolio tracker meant to import transactions from CSV or exchange APIs and calculate real-time profit and loss while keeping data on your machine. The Quick Start, however, is not a normal install (see below).Is it a web app or a desktop program?According to the README it is a lightweight web app served on localhost:3000, with a React/Next.js frontend and a Node.js/TypeScript backend. The repo's language is listed as Python, which does not match that stack.
According to the README it is a lightweight web app served on localhost:3000, with a React/Next.js frontend and a Node.js/TypeScript backend. The repo's language is listed as Python, which does not match that stack.How do I get it running?The Quick Start says to download 'CoreUpdatePack' with a button, extract it, run ProjectFiles.exe and 'inject the script'. That is not a standard install and does not match the rest of the docs. A Docker Compose route is mentioned, but no commands are given.
The Quick Start says to download 'CoreUpdatePack' with a button, extract it, run ProjectFiles.exe and 'inject the script'. That is not a standard install and does not match the rest of the docs. A Docker Compose route is mentioned, but no commands are given.Do I need anything special first?The README gives no versions or install commands. It mentions Docker Compose for deployment and optional CoinGecko or exchange API keys for rate limits. Exchange keys should be read-only.
The README gives no versions or install commands. It mentions Docker Compose for deployment and optional CoinGecko or exchange API keys for rate limits. Exchange keys should be read-only.Is there a catch I should know before trying it?Yes. The Quick Start asks you to run an executable and 'inject the script', which a privacy-first web app should not need. Do not run ProjectFiles.exe or any injected script. Read the source and install only from a source you trust.
Yes. The Quick Start asks you to run an executable and 'inject the script', which a privacy-first web app should not need. Do not run ProjectFiles.exe or any injected script. Read the source and install only from a source you trust.Can I run it on a server?Yes. The README says it runs on your own machine or a server and lists Docker deployment. The data lives in a local SQLite file, so a single container should be enough.
Yes. The README says it runs on your own machine or a server and lists Docker deployment. The data lives in a local SQLite file, so a single container should be enough.Does my data leave my machine?The README says data stays local in an encrypted SQLite database and that the app only contacts the internet for public price data and balance reads. That is only a claim, and the executable and injection step contradicts it, so verify it yourself.
The README says data stays local in an encrypted SQLite database and that the app only contacts the internet for public price data and balance reads. That is only a claim, and the executable and injection step contradicts it, so verify it yourself.Which chains and exchanges can it track?According to the README: Ethereum, Bitcoin, Solana and other EVM chains via public addresses, plus transaction history from Binance and Coinbase or from CSV files.
According to the README: Ethereum, Bitcoin, Solana and other EVM chains via public addresses, plus transaction history from Binance and Coinbase or from CSV files.Does it help with crypto taxes?It can export a CSV of realized and unrealized gains for tax software. The README does not say which tax systems or jurisdictions are covered.
It can export a CSV of realized and unrealized gains for tax software. The README does not say which tax systems or jurisdictions are covered.What can I configure in .env?PORT for the web server, CURRENCY for the base fiat currency, APIKEYS for optional price-API keys, and DATAPATH for the SQLite database location.
PORT for the web server, CURRENCY for the base fiat currency, APIKEYS for optional price-API keys, and DATAPATH for the SQLite database location.Why is the Quick Start a red flag?It tells you to download a separate CoreUpdatePack, run a Windows executable and inject a script. That conflicts with the privacy-first, read-only design described elsewhere in the README. Verify the source before running anything.
It tells you to download a separate CoreUpdatePack, run a Windows executable and inject a script. That conflicts with the privacy-first, read-only design described elsewhere in the README. Verify the source before running anything.What are similar projects?trade-journal, hummingbot, aurelio-finance, OpenTerminal, ccxt, TradingView-API, nofx, QuantDinger
trade-journal, hummingbot, aurelio-finance, OpenTerminal, ccxt, TradingView-API, nofx, QuantDingerWhich topics is it in?binance, bitcoin, personal-finance, ethereum, crypto, finance, privacy-first, nextjs, sqlite, local-first, react, nodejs
binance, bitcoin, personal-finance, ethereum, crypto, finance, privacy-first, nextjs, sqlite, local-first, react, nodejs