indian-stock-analyst:把 Zerodha / Groww 持仓 CSV 变成 Buy / Hold / Avoid 股票报告
Fanchettehomoecious641/indian-stock-analyst
indian-stock-analyst 是一款 Windows 工具,可读取 Zerodha 或 Groww 的持仓 CSV,为每只股票生成 Buy、Hold 或 Avoid 的简明标签报告。输入为 holdings.csv、portfolio.csv 等券商导出文件,输出为便于快速浏览的组合摘要,面向希望免看图表和比率就完成持仓复盘的非技术用户。
📊 indian-stock-analyst - Turn CSVs Into Clear Stock Reports
🧩 What this does
indian-stock-analyst turns your Zerodha or Groww portfolio CSV into a clean stock report.
It reads your holdings file and builds a simple Buy, Hold, or Avoid view for each stock. You can use it to review your portfolio without digging through charts, ratios, or market noise.
This tool is built for Windows users who want a fast way to check their stock list and get a plain report they can read at a glance.
💻 Before you start
You need:
- A Windows PC
- Your Zerodha or Groww portfolio CSV file
- A web browser to open the download page
- Enough space to save the app and report files
Best results come from a recent Windows 10 or Windows 11 system.
🚀 Download and install
Use this link to visit the download page and get the app:
After you open the page:
- Find the latest release or download file
- Save it to your PC
- If the file is zipped, extract it
- Open the app file
- Follow the on-screen steps to load your CSV
- Wait for the report to finish
If Windows asks for permission, choose the option that lets the app run.
🗂️ Prepare your CSV file
Before you run the app, make sure your portfolio file is ready.
For Zerodha, export your holdings or portfolio data as CSV.
For Groww, download the portfolio CSV from your account dashboard.
Keep the file in a folder you can find again, such as:
- Downloads
- Desktop
- Documents
Use a fresh export if your holdings changed since the last file.
🖱️ How to run it on Windows
- Download the app from the link above
- Open the saved file on your computer
- If Windows shows a security prompt, select the option to continue
- Choose your Zerodha or Groww CSV file
- Wait while the app reads your holdings
- Open the report it creates
If the app creates a folder with output files, check the same folder where you saved the app.
📈 What the report shows
The report gives you a stock view in plain language. It is made to help you review your holdings fast.
You can expect:
- A Buy, Hold, or Avoid label for each stock
- A clean summary of your portfolio
- Basic stock checks based on the input file
- A clear list that is easy to scan
- A report format that works well for non-technical users
The goal is simple: help you read your portfolio without working through a full market dashboard.
🧠 How it helps
This tool is useful when you want to:
- Review your current holdings
- Compare stocks in one place
- Spot weak positions in your list
- Save time on manual review
- Get a quick view before a deeper check
It is a good fit for users who track Indian stocks through Zerodha, Groww, or Kite and want a simple report from a CSV file.
📁 Expected file types
Use CSV files from your broker or portfolio app.
Common file names may look like:
- holdings.csv
- portfolio.csv
- positions.csv
- groww-portfolio.csv
- zerodha-holdings.csv
If your file does not load, export it again from the source account and try the new file.
⚙️ Basic workflow
- Export your portfolio CSV
- Download the app
- Open the app on Windows
- Load the CSV file
- Review the Buy, Hold, or Avoid report
- Save or share the output as needed
🔍 Tips for best results
- Use the latest CSV export
- Keep only one file open at a time
- Avoid renaming columns in the CSV
- Save the file in a simple folder path
- Use one portfolio file per run
If your file comes from a broker export, keep the default format intact.
🧭 Common use cases
This app works well for:
- Personal portfolio review
- Monthly stock checks
- Quick screening of Indian shares
- A simple view of large and small holdings
- Users who want a report without extra setup
🛠️ If the app does not open
Try these steps:
- Check that the file finished downloading
- Make sure you extracted the zip file, if there is one
- Right-click the app and open it again
- Confirm that your Windows account can run downloaded files
- Try a newer CSV export from Zerodha or Groww
If the file path is too long or has special characters, move the file to Desktop and try again.
📌 Project details
- Repository: indian-stock-analyst
- Purpose: Turn portfolio CSV files into a stock report
- Input: Zerodha or Groww CSV
- Output: Buy / Hold / Avoid report
- Platform: Windows
- Topic area: stock analysis, Claude skill, Indian market, portfolio review
🧾 File handling notes
To keep things simple:
- Do not edit the CSV in a way that changes the column layout
- Keep backup copies of your original export
- Use a folder with a clear name
- Run one report at a time
🔗 Download again
If you need the download page later, use this link:
🧰 Suggested folder setup
You can keep your files like this:
Downloads\indian-stock-analystDocuments\Stock ReportsDesktop\CSV Files
A simple folder layout makes it easier to find your CSV and the report later
📝 Example flow
- Log in to Zerodha or Groww
- Export your holdings as CSV
- Save the file to Desktop
- Open the app you downloaded
- Select the CSV file
- Read the generated report
🔎 What to expect in the report style
The report is built to be direct.
It should:
- Use simple labels
- Group the main stock view clearly
- Keep the format easy to read
- Focus on action, not clutter
- Present your portfolio in a way that feels organized
来源:GitHub · github.com