OpenAshare

English · 简体中文

An open-source stock research desk for US, mainland China, and Hong Kong markets.
Bring prices, news, company filings, charts, and your research questions into one workspace.

GitHub stars · MIT License

OpenAshare helps you follow a company, review the available evidence, and ask focused follow-up questions. It supports English and Simplified Chinese, with English as the default.

See it in action

Screenshots

_{Select a screenshot to watch the product demo.}

What you can do

• Search stocks and review price charts and technical context.
• Explore company news, market themes, and available filings.
• Ask follow-up questions with research context carried through the conversation.
• Keep watchlists, portfolio notes, and research conversations together.

OpenAshare is for research only. It does not provide investment advice or place trades.

Supported markets

Market	Examples	Coverage
US	AAPL, NVDA	Price history, news where available, and SEC filings for eligible companies.
Mainland China	sh600036, sz000001	A-share search and price history, plus China-focused news and market themes.
Hong Kong	00700.HK	Price history, charts, and Hang Seng market context.

Data coverage varies by market, symbol, and provider. Some data may be delayed or unavailable; check the linked source and date before relying on it.

Run locally

You need Python 3.12+, Node.js 22, and npm.

Install the dependencies:

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements_api.txt
npm install

For AI research, create a .env file in the project root and add your model provider settings:

LLM_API_KEY=your_api_key
LLM_BASE_URL=https://api.deepseek.com
LLM_MODEL=deepseek-flash

Keep API keys in your local .env file. Do not commit them. The app can start without a model key, but AI research features will be limited.

Start the API and web app in separate terminals:

./scripts/run_api.sh

npm run dev

Open http://localhost:3000. For optional provider and SEC configuration, see US research notes and .env.docker.example.

Star history

License

OpenAshare is licensed under the MIT License.