TenBagger
Analyse your stocks and crypto as one portfolio
Install / Use
/learn @moijk-arko/TenBaggerREADME
TenBagger, Find your next TenBagger inside your terminal
Why paying for expensive subscriptions to track your portfolio, dividends and crypto? This library aims to be a complete tool to track and analyse your financial portfolio using the Command Line Interface (CLI). All the features of TenBagger will be displayed as a Textual User Interface (TUI) inside your terminal.
This library uses the yfinance API to fetch the market data. So you need to use the ticker symbols as they are on Yahoo finance. This also means that the stability of TenBagger is bound to the stability of Yahoo finance.
Compatibility
Linux/macOS or any other unix based system.
Installation
git clone https://github.com/AramKoorn/TenBagger
cd TenBagger
python3 setup.py install && pip3 install .
Check if installation worked:
tenbagger -v
Getting Started
Configuration files are stored in the user's root folder.
Configure your portfolio
vi ~/.tenbagger/portfolio.yaml
Configure staking rewards
vi ~/.tenbagger/staking.yaml
Configure preferred currency
vi ~/.tenbagger/environment.yaml
Alternatively, you can change the files in the ~/.tenbagger folder with your preferred text editor.
Usage
Real-time overview of portfolio. The portfolio automatically gets updated with the real-time stock/crypto prices while the app is running. The app can be closed by hitting q or CTRL+C.
tenbagger --portfolio WSB

Overview of Bond markets. Currently supported:
- United states (us)
- Germany (germany)

tenbagger --bonds us
Simulate passive income of dividend payouts and staking rewards
# portfolio: Name of portfolio specified in config/portfolio.yaml
# n: number of months
# stockgrowth: yearly Stock growth rate
# dividendgrowth: yearly dividend growth
# m: montlhy payment
# crypto: boolean to include crypto in simulation
# report: Boolean to generate csv report of simulation
tenbagger --scenario -n 120 --stockgrowth 0.03 --dividendgrowth 0.03 -m 1000 --crypto --report --portfolio my_portfolio
Show different metrics of the listed ticker. Note that this is supported for both stonks and crypto.
$ tenbagger --overview aapl
$ tenbagger --overview btc-eur

Candlestick chart
tenbagger --candle --ticker ibm --period 700d --interval 1d
Run tracker dashboard
tenbagger --tracker
Crypto
For some crypto we directly support the network addresses so that you don't have to update the portfolio json file when you buy or sell some of your crypto. E.g.
my_crypto:
algo-eur: "3C5IFPAZLET3FLGGFK5AXN7NISVD3OCOMEZJESCXUNUHDOIPMVKYB4DILM"
atom-eur: "cosmos1vjnlkndnekvrnfrp5j3wtsvsezlgwfm9cmrqe9"
We will add more blockchains over time. Currentlly supported blockchains are:
- Algorand (algo)
- Cosmos (atom)
Tasks
- [ ] Create on click button to refresh portfolio on demand
- [ ] red/green if above or below fair value
- [ ] track portfolio over time using postgres as backend
- [ ] GAK
- [x] Portfolio properties
- [x] Total dividends
- [x] Total staking rewards
- [x] Total passive income
- [ ] Pull upcoming ex dividend dates
Related Skills
claude-opus-4-5-migration
83.2kMigrate prompts and code from Claude Sonnet 4.0, Sonnet 4.5, or Opus 4.1 to Opus 4.5
model-usage
337.3kUse CodexBar CLI local cost usage to summarize per-model usage for Codex or Claude, including the current (most recent) model or a full model breakdown. Trigger when asked for model-level usage/cost data from codexbar, or when you need a scriptable per-model summary from codexbar cost JSON.
TrendRadar
49.8k⭐AI-driven public opinion & trend monitor with multi-platform aggregation, RSS, and smart alerts.🎯 告别信息过载,你的 AI 舆情监控助手与热点筛选工具!聚合多平台热点 + RSS 订阅,支持关键词精准筛选。AI 智能筛选新闻 + AI 翻译 + AI 分析简报直推手机,也支持接入 MCP 架构,赋能 AI 自然语言对话分析、情感洞察与趋势预测等。支持 Docker ,数据本地/云端自持。集成微信/飞书/钉钉/Telegram/邮件/ntfy/bark/slack 等渠道智能推送。
mcp-for-beginners
15.6kThis open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable, and secure AI workflows from session setup to service orchestration.
