git404hub

what is a-share-us-catalyst fr?

yespsam/a-share-us-catalyst — explained in plain English

Analysis updated 2026-05-18

96PythonAudience · developerComplexity · 3/5Setup · moderate

tl;dr

A command line and web research tool that scores Chinese A share candidates each morning based on overnight US market moves, momentum, and news, for research only.

vibe map

mindmap
  root((CatDesk 9))
    What it does
      Daily A share candidate report
      Scores stocks by momentum and news
      Backtests scoring history
      Publishes a web dashboard
    Tech stack
      Python
      CLI
      Netlify
      Telegram bot
    Use cases
      Research A share candidates each morning
      Automate a daily market report
      Track high potential early stage stocks
    Audience
      Investors
      Developers
      Market researchers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Generate a daily research report linking overnight US market moves to A share candidates.

VIBE 2

Automate a scheduled morning report using a local scheduled job.

VIBE 3

Publish a public web dashboard of market signals to Netlify.

VIBE 4

Receive daily candidate reports through a Telegram bot.

what's the stack?

PythonCLINetlifyTelegram Bot API

how it stacks up fr

yespsam/a-share-us-catalystastraltenprosper/uncensored-ai-image-video-generatoryoheinakajima/activegraph
Stars969696
LanguagePythonPythonPython
Setup difficultymoderateeasyeasy
Complexity3/52/54/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Real data mode depends on external market data endpoints that can change without notice, sample data mode works offline.

The README does not state a license for this repository.

in plain english

CatDesk 9 is a research tool that generates a daily morning report at 9am linking overnight moves in US stocks to candidate stocks in the Chinese A share market. It combines how US market themes moved overnight, how A shares have historically reacted the next day, individual stock momentum, recent news catalysts, and risk warnings into a single score, then lists five candidate stocks per sector. The README is explicit that this output is research material and risk notes, not an unconditional buy signal, and that real trading decisions still depend on personal risk tolerance, position sizing, stop losses, liquidity, and the actual opening price. For data, it prefers lightweight direct connections to sources like Sina, Yahoo, and Eastmoney for US and A share prices, historical data, and news, with a slower library called AkShare kept as an optional fallback since it is not enabled by default. Because these external endpoints can change without notice, the tool includes caching and graceful failure handling. To run it, you clone the repository, set up a Python virtual environment, install the dependencies, and run a command line tool that writes a markdown and JSON report into a reports folder. There is also a sample data mode that lets you check the formatting and scoring logic without needing a live network connection. On macOS, a script can install a scheduled job that runs the report automatically every trading day morning, and a separate script can rebuild and publish a public website version to Netlify on the same schedule. The web version also includes sections for US stock picks filtered by quality and valuation, coverage of Japanese and Korean markets, a section for early stage high potential stocks, and a page showing backtested performance of the scoring approach over the past six months. Results can also be pushed to a Telegram chat using a bot token. The README states the tool is for entertainment and public information organizing only, and does not constitute investment advice.

prompts (copy fr)

prompt 1
Walk me through setting up this tool to run automatically every trading day at 9am.
prompt 2
Explain how the scoring system combines US market signals with A share momentum and news.
prompt 3
Show me how to configure the stock pools in the themes.json config file.
prompt 4
Help me set up the Telegram bot integration for daily report delivery.
prompt 5
Explain how the sample data mode works for testing without live network access.

Frequently asked questions

what is a-share-us-catalyst fr?

A command line and web research tool that scores Chinese A share candidates each morning based on overnight US market moves, momentum, and news, for research only.

What language is a-share-us-catalyst written in?

Mainly Python. The stack also includes Python, CLI, Netlify.

What license does a-share-us-catalyst use?

The README does not state a license for this repository.

How hard is a-share-us-catalyst to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is a-share-us-catalyst for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.