Tai Alpha Stock

Canonical docs: /setup (README, USERFLOW, MODULE_STRUCTURE, guides).
Mirror: setup/docs/core/SKILL.md.
Agents (Cursor / Claude Code / OpenClaw): setup/docs/core/AGENTS.md — root stubs AGENTS.md, CLAUDE.md.

Workflow tree

Single: python scripts/analyze.py TICKER → pipeline; stores rows in SQLite (--db-path optional).
Personas / markets: --persona id / --persona-all; --market auto|us|hk|cn; --lang zh-CN|zh-HK (see setup/docs/guides/PERSONA_ECOSYSTEM_GUIDE.md).
Fast / depth: --fast skips ML and uses lighter collect; --depth lite|standard|deep (see setup/README.md matrix).
Batch: python scripts/batch.py TICKER1 TICKER2 (optional --fast, --depth).
Portfolio: python scripts/portfolio.py TICKER ...
Cron: python scripts/cron.py (TAI_ALPHA_HOTLIST, optional TAI_ALPHA_TELEGRAM_WEBHOOK)
Alerts: python scripts/alerts.py (watchlist in SQLite)
Custom / ML / sector: scripts/custom.py, scripts/ml.py, scripts/sector.py
Dividends / movers: scripts/dividends.py, scripts/hot_scanner.py (see setup README)
Inspect run: python scripts/report.py --run-id N / python scripts/score.py --run-id N (--deep-risk on score CLI)

Docs

Related projects (inspiration)

Test

pip install -e ".[dev]"
pytest tests/unit tests/integration -v
python setup/tools/check_structure.py