mrkeyoor.com_
Tue 01 Sept 17:44 UTC
Self-Hostedevaluationupdated 23 Aug 2026

tick-stock-panel review

Tick Stock Panel is a Chinese-language, self-hosted workstation for screening, monitoring, backtesting, and reviewing mainland China A-shares. Its README and linked documentation are in Chinese, and we found no English documentation. It gives individual traders one local interface for market data, strategy research, watchlists, alerts, and optional AI analysis.

+269stars / 7d
Verdict

Tick Stock Panel is worth trying for a Chinese-reading A-share hobbyist who wants local data and a broad research interface. It is a poor foundation for unattended or commercial work today: the license messaging conflicts, our test run failed heavily, and open data-pipeline issues can affect results. Use it as a research bench with checked inputs, pinned code, and no automatic trading authority.

We ran it

Lab card: what happened when we ran tick-stock-panelScreenshot of tick-stock-panel (github.com/shy3130/tick-stock-panel)
Install✓ · 14s33 packages · 36 MB
Build✓ · 6s
Tests✗ · 80s77 passed · 21 failed · 105 errors of 203 (pytest)
Known vulns0(pip-audit)
Repo588 files~150,224 lines of source · 18.7 MB · 2 CI workflows · tests dir

Answers from our run

Does tick-stock-panel build from source?

Dependencies installed in 14 seconds (33 packages), and the build succeeded in 6 seconds. We cloned commit 38186e2 into a clean Debian container with 3 CPUs and no project-specific setup.

Do tick-stock-panel's tests pass?

Not all of them: 77 of 203 passed and 21 failed when we ran the project's own test command (pytest), with 105 collection errors. Some failures need services or credentials a bare container does not have.

Does tick-stock-panel have known vulnerabilities in its dependencies?

pip-audit found none in the dependency tree at the time of our run.

Who should not use tick-stock-panel?

English-only users: the README, setup guide, configuration reference, interface examples, and linked manuals are in Chinese, with no English guide listed.

What are the alternatives to tick-stock-panel?

VeighNa, Qlib, LEAN. Tick Stock Panel is worth trying for a Chinese-reading A-share hobbyist who wants local data and a broad research interface.

Setup2/5Install and build passed, but tests and first data setup did not
Docs3/5Detailed Chinese guides, with conflicts and no English edition
Community4/5Current pushes and active issue and pull-request traffic
Maturity2/5Young project with failing tests and open data correctness bugs

Who it’s for

Chinese-speaking individual traders who want A-share screening, watchlists, backtests, and alerts in one local web interface.
Quant hobbyists who prefer Parquet and DuckDB storage they can inspect and copy themselves.
Developers willing to connect TickFlow or write a custom data-source plugin for their own licensed feed.
Researchers who want optional OpenAI-compatible strategy generation without making AI a requirement for the basic workflow.

Who it’s NOT for

English-only users: the README, setup guide, configuration reference, interface examples, and linked manuals are in Chinese, with no English guide listed.
Commercial teams that need unambiguous reuse terms: the LICENSE is MIT, while the README says the project is for study and research and strictly forbids commercial use. Get that conflict resolved before adopting it.
Traders working mainly with US or Hong Kong stocks: the product is built around mainland China A-shares, and issue #135 is still a request to add those markets.
Operators depending on unattended large data refreshes: issue #189 reports active pipeline jobs being cancelled after 20 minutes, and issue #174 reports a multiyear Windows rebuild exhausting memory and freezing the app.
Anyone relying on ETF volume without extra checks: issue #195 reports that A-share and ETF volume use different units, which can produce a 100-fold conversion mistake.
Hosts that cannot allow the app container to read local Codex login state: the documented Codex mode mounts the host credential directory read-only into the container.

Setup reality

On commit 38186e2, our fresh Debian sandbox installed 33 Python packages in 14 seconds, using 36 MB, and completed the build in 6 seconds. Pytest failed in 80 seconds: 77 passed, 21 failed, and 105 collection or setup errors were reported across 203 tests. Pip-audit found 0 known vulnerabilities. The checkout contained 588 files, about 150,224 source lines, and occupied 18.7 MB; the harness saw two CI workflows, a tests directory, and no Dockerfile in the detected backend project.

The README's development path needs Python 3.11 or newer, Node 20 or newer, uv, pnpm, and a copied .env. A TickFlow API key is optional for historical daily data but unlocks more feed capabilities. AI analysis needs an OpenAI-compatible service or Ollama. The Docker instructions also describe mounting host Codex credentials for Codex-backed features.

Running the interface is only the start. You must execute the post-market pipeline before screening or backtesting useful data, choose a licensed data source, and configure access protection for any public deployment. Older CPUs need a compatibility extra, while vectorbt backtesting is another optional dependency set. The current deployment guide says the stock-sdk scraper is excluded from default Docker builds for compliance reasons, despite the root README saying it is included.

A personal workstation for mainland China stocks

Tick Stock Panel is built for people researching mainland China A-shares. Its vocabulary, data model, screenshots, and documentation assume that audience. The browser interface collects watchlists, screeners, backtests, alerts, market reviews, financial views, and sector analysis around a local store. The README explicitly calls it a learning and research project rather than investment or charting software.

Eighteen included strategies give a new user something concrete to scan, while custom conditions and strategy files leave room for personal rules. Backtesting covers factor analysis and strategy results, with stated support for T+1 settlement, fees, slippage, and stop-loss settings. Monitoring can watch strategy signals, individual stocks, prices, or exchange-defined abnormal moves. The software does not place trades, which is a sensible boundary for a young personal project.

Data stays in local Parquet and DuckDB files. Polars handles much of the calculation work, and the React interface talks to a FastAPI backend. TickFlow is the default source, but the project also documents YAML sources and plugin development.

What happened when we ran it

We tested commit 38186e2 in a fresh, unprivileged Debian container with 3 CPUs and 8 GB of RAM. The detected Python project was under ./backend/. The checkout was 18.7 MB and contained 588 files with about 150,224 source lines. Installation succeeded in 14 seconds: 33 packages occupied 36 MB. The build also succeeded, taking 6 seconds.

The test result was much weaker. Pytest exited with failure after 80 seconds. Of 203 tests, 77 passed, 21 failed, and 105 hit collection or setup errors. The end of the log named files covering strategy monitoring, parameter normalization, realtime refresh, the strategy registry, scoring, watchlist joins, OCR, groups, and realtime splitting. Those filenames show a wide failure surface, but the supplied log tail does not establish one cause, so we will not blame missing system packages or application defects without evidence.

Pip-audit found 0 known vulnerabilities in the installed Python packages. The repository had two CI workflow files and a tests directory. Our harness reported no Dockerfile in the detected backend project, while the current root documentation offers a Docker Compose build for the full frontend and backend.

Setup is more than starting a container

The development instructions require Python 3.11 or newer, Node 20 or newer, uv, and pnpm. A helper script installs dependencies and starts both servers. Docker Compose is the shorter deployment route, with the built frontend served from the backend container.

A blank TickFlow API key permits historical daily bars through a free endpoint, with current-day data arriving one or two hours after market close. Paid feed capabilities add wider realtime coverage, minute bars, order-book data, and financial data. An OpenAI-compatible endpoint or Ollama is optional for generated strategies and AI analysis. The documented Codex mode reads a host Codex login directory through a read-only container mount, so operators should enable it only on a trusted machine.

The data pipeline is the part the phrase "zero maintenance" understates. A first useful session requires downloading market history and building enriched tables before screeners and backtests have material to work with. Vectorbt arrives through an optional backtest dependency group. Older processors without AVX2 or FMA need a separate Polars-compatible extra. The deployment guide also says the stock-sdk scraper is excluded from default Docker builds because of third-party terms and market-data copyright concerns. The root README says that plugin is included, so the two documents currently disagree.

Data correctness needs your attention

Open reports touch the numbers a trader would act on. Issue #195 says A-share volume is expressed in lots while ETF volume is expressed in shares. A consumer that applies the stock conversion to an ETF can be wrong by a factor of 100. Other open ETF reports cover an empty single-symbol factor-backtest view and unsupported screener fields. ETF support exists, but it should be treated as unfinished.

Long data jobs have operating risks too. Issue #189 documents pipeline work that kept reporting progress yet was marked failed after a fixed 20-minute timeout. The report also warns that retrying may overlap the still-running worker and write the same files. Issue #174 describes a Windows full rebuild freezing after multiyear history expanded the working set. These are precise reports with reproductions, and both remain open.

Commercial adopters face a separate stop sign. The repository contains the standard MIT license text, including permission to sell copies, while the README says commercial use is strictly forbidden. A README sentence does not clarify how the author intends the MIT grant and restriction to coexist. A business should obtain written clarification before building on it.

Active development has not become a stable release

The last push was August 23, 2026, the same day a new ETF filtering issue was opened. The repository had 3,472 stars and 29 open issues and pull requests combined. Filtering that queue produced 18 issues and 11 pull requests, which shows both user reporting and ongoing code work. GitHub's latest-release endpoint returned 404, so there is no published GitHub release to use as a stable upgrade point.

The documentation is substantial for such a young repository. Separate Chinese guides cover deployment, configuration, features, strategy authoring, data-source plugins, mining, and market phases. English readers receive no equivalent path, and the stock-sdk disagreement shows why even Chinese readers should compare the root README with the deeper deployment guide.

For a Chinese-speaking hobbyist, this is an unusually broad A-share research bench with understandable local storage and room for custom feeds. Keep it away from automatic order execution, verify ETF units, watch long pipeline jobs, and pin a commit you have tested. The failed suite and missing release boundary make those precautions part of normal use, not optional hardening.

Alternatives

ProjectWhat it isPick it when
VeighNaA Python quantitative trading framework with gateways, apps, and live-trading infrastructure.pick this instead when broker connectivity and an extensible trading system matter more than a ready-made personal research panel.
Qlib gh↗A quantitative research platform centered on machine-learning experiments and model workflows.pick this instead when your main job is training and evaluating predictive models rather than operating a browser dashboard.
LEANA multi-asset algorithmic trading engine for research, backtesting, and execution.pick this instead when you need broader markets, brokerage integrations, or a mature engine and can accept more engineering work.

What people are saying

  1. [github-trending] shy3130/tick-stock-panel

Sources

  1. Tick Stock Panel repository
  2. Project README
  3. Deployment guide
  4. Configuration guide
  5. MIT license file
  6. Active pipeline timeout issue
  7. Windows rebuild memory issue
  8. ETF volume unit issue

More self-hosted reviews

v2 · OpenShell · wigolo · Mindwtr · club-3090 · reclip · the whole board →