marketmyna 0.2.0

Stock analysis, screening, portfolios and alerts in one app.
AI analysts, Shariah screening and alerts on Telegram, for India, the US, China, Hong Kong and crypto.

Try it online · Run your own copy · Features · Report a bug

Use it at https://marketmyna.com/, or run your own copy from this repo. Your copy has no sign-up, no login, no plans and no limits: it has one owner (you), and every feature is on.

MarketMyna is an analysis tool, not investment advice.

Features

🤖 AI analysis A set of AI analysts (technical, risk, news) explains a stock in plain language, with a bullish / neutral / bearish outlook, never a buy or sell call. Paste your own key (Gemini, OpenAI, Claude, Groq, OpenRouter, DeepSeek, Mistral) or point it at a local Ollama.
	🔎 Screeners and Shariah screening India (NSE, BSE, mutual funds, ETFs), US, China A-shares, Hong Kong and crypto, with ready-made and custom screens. Ethical / Shariah checks for stocks, mutual funds and ETFs, with dividend purification.
🧭 Market insights Sector and fund rotation, trending stocks, market mood, FII / DII flows, world markets, rates and macro, all on one page.
	💬 Telegram bot and console Every tool is also a chat command. Ask the Telegram bot, or use the same commands in the built-in console.

More screenshots

Compare stocks side by side	Scheduled reports

Quick start

With Python 3.11 or newer on Linux, macOS or Windows:

pipx install marketmyna
marketmyna

The app opens at http://127.0.0.1:8001. Paste an AI key in Settings and look up any stock. Update with pipx upgrade marketmyna; your data is kept.

No pipx? pip install marketmyna inside a virtual environment works the same way (how to install pipx). Other options: marketmyna --port 9000, marketmyna --no-browser.

Run it from the source code

To follow the latest code with git pull, or to change it. Runs on Linux, macOS and Windows (tested on all three on every change). Needs Python 3.12 and Node.js 22. All your data goes into one SQLite file, so there is no database server to set up.

1. Get the code and install (one time)

Linux and macOS:

git clone https://github.com/pryndor/MarketMyna.git marketmyna
cd marketmyna
python3 -m venv venv
. venv/bin/activate
pip install -r requirements-web.txt

Windows (PowerShell):

git clone https://github.com/pryndor/MarketMyna.git marketmyna
cd marketmyna
py -m venv venv
venv\Scripts\Activate.ps1
pip install -r requirements-web.txt

If PowerShell refuses to run the activate script, run Set-ExecutionPolicy -Scope CurrentUser RemoteSigned once, or use Command Prompt with venv\Scripts\activate.bat.

2. Start it (every time; activate the venv first as above)

python start.py

The first start builds the frontend (about a minute), then the app opens in your browser at http://127.0.0.1:8001. Other options: --port 9000, --no-browser, --rebuild.

3. Update (whenever you like)

git pull
pip install -r requirements-web.txt
python start.py

The frontend rebuilds by itself when it has changed, and your data is kept.

Then open http://127.0.0.1:8001 and go to Settings:

• AI keys: paste a key; add several for automatic fallback.
• Notifications: Telegram, email and the other channels, and which messages go where.
• Data sources (optional): live US prices, backup price sources, Reddit.

Everything can also be set with environment variables; .env.example lists them.

Run only one copy at a time: the scheduler, price alerts and the Telegram bot run inside it.

Your data

Everything is under ~/.marketmyna (on Windows C:\Users\<you>\.marketmyna; set MARKETMYNA_HOME to use another folder):

• marketmyna.db: the SQLite database (watchlists, portfolios, alerts, journal, reports, settings). The tables are created on first start, and columns are added on later updates.
• config.json and secret.key: your settings, and the key that encrypts saved API keys and passwords.

To back up or move the app, copy the whole folder while the API is stopped. An existing stockpulse.db from before the rename is still used.

Keep it private

There is no login, so anyone who can reach the port can use the app and see your data. The app listens on 127.0.0.1 only by default, so only this computer can reach it. To use it from your phone, use a private network such as Tailscale or WireGuard. Don't open the port to the internet.

Troubleshooting

Still stuck? Open an issue with your OS, Python version and the error text.

Development

Run the API on its own, and the Vite dev server for live reload of the frontend:

python -m uvicorn marketmyna.api.app:app --port 8001 --reload
cd frontend && npm run dev   # another terminal: http://localhost:5174, sends /api to :8001

If the API runs on another port, start the frontend with MARKETMYNA_API=http://127.0.0.1:<port> npm run dev.

Tests: pip install pytest && python -m pytest -q. GitHub Actions runs them, builds the frontend and starts the app on Linux, Windows and macOS for every push (.github/workflows/ci.yml).

Layout

Built with

Roadmap

• More options for scheduled reports: what goes in them, when they run, and where they are sent
• More markets and data sources
• More AI analysts and strategy playbooks

Ideas and requests are welcome in Issues.

Support

MarketMyna is free and open source. If it helps you, you can support its development:

• GitHub Sponsors, monthly or one-time
• Buy Me A Coffee

License

MarketMyna is free and open source under the Apache License 2.0. Copyright 2026 Balasubramanian Periannan; see NOTICE.

In short (the LICENSE file is what counts):

The license also gives you a patent license from the contributors. It comes with no warranty, and the authors are not liable for any loss.

Contributing

Pull requests are welcome. Contributions are accepted under the Apache License 2.0; see CONTRIBUTING.md.

Name and logo

The license does not cover the MarketMyna name and logos (frontend/public/brand/). If you publish a changed copy, give it your own name and logo.

Third-party software

Each package the app installs keeps its own license. The frontend packages and the Python packages are MIT, BSD, ISC or Apache-2.0, except PyMuPDF (AGPL-3.0), which is used only to make PDF reports. If you ship MarketMyna inside a closed product, check PyMuPDF's terms or remove it.

Not investment advice

MarketMyna is an analysis tool. Nothing it shows is investment advice, and you trade at your own risk.