hamuna-quant-cli

A 股回测 + 实盘统一 CLI (akquant 0.3.x).

替代 v1 自建 driver (hamuna-strategy) + QMT-style (init/handlebar/passorder). 同一份策略代码天然兼容回测与实盘 (akquant Strategy 双引擎一等公民).

安装

pip install hamuna-quant-cli
# 或本地源码装
pip install -e /path/to/hamuna-strategy-platform
# 或本地 wheel
pip install /path/to/hamuna_quant_cli-*.whl

Windows / macOS / Linux 全支持 (Python ≥3.10).

依赖: akquant>=0.3.41,<0.4 (Rust + Python 混合引擎).

构建 (版本号自动更新)

每次构建版本号自动 +1 (基于 git 提交数):

# 一键: 先 bump 版本 → 再 build wheel + sdist
bash scripts/build_python.sh

# 或手动两步 (效果相同)
python3 scripts/bump_version.py --python
python3 -m build

产物在 dist/。版本格式 0.1.0.dev<git提交数> (PEP 440),同一 commit 版本可重现。

子命令一览

命令	用途
`hamuna_quant_cli run <strategy.py> --config cfg.json`	跑 akquant backtest → result.json
`hamuna_quant_cli check <strategy.py> --config cfg.json`	8 条纪律静态审查 (不回测)
`hamuna_quant_cli upload <strategy_id> --result result.json`	PUT metrics → server
`hamuna_quant_cli create --name ... --config ...`	新建 strategy 拿 strategy_id
`hamuna_quant_cli parity`	5 内置 strategy × 1 universe parity test
`hamuna_quant_cli qmt-translate <strategy.py> cfg.json`	akquant → QMT body 翻译 (本地 stub)
`hamuna_quant_cli commit <strategy_id>`	5 步打包上传 (translate + bundle + PUT + POST + export)
`hamuna_quant_cli dataset {list\|fetch\|manifest}`	prebuilt 数据集管理
`hamuna_quant_cli live run <strategy.py>`	实盘 / 仿真运行 (包装 akquant.run_live)

端到端回测 (10 行)

# 0) 安装
pip install hamuna-quant-cli

# 1) 写策略
cat > /tmp/s.py <<'EOF'
# coding: utf-8
from akquant import Strategy
class S(Strategy):
    warmup_period = 1
    def on_bar(self, bar):
        if self.get_position(bar.symbol) == 0:
            self.buy(bar.symbol, 100)
EOF

# 2) 写 cfg
cat > /tmp/c.json <<'EOF'
{
  "backtest_start": "20240701",
  "backtest_end":   "20241231",
  "pool":           {"hs300": {"codes": ["600000.SH", "600036.SH"]}},
  "init_capital":   1000000.0
}
EOF

# 3) 静态审查
hamuna_quant_cli check /tmp/s.py --config /tmp/c.json
# 期望 stderr: "纪律 self-check 通过 (0 条)"

# 4) 跑回测
hamuna_quant_cli run /tmp/s.py --config /tmp/c.json --output /tmp/r.json

# 5) 上传 (auto-create strategy)
hamuna_quant_cli upload --name "v2_smoke" --config /tmp/c.json --code /tmp/s.py --result /tmp/r.json

实盘 (5 行)

# 1) 写策略 (同上)

# 2) paper 模式 (smoke, 不连真实 broker)
hamuna_quant_cli live run /tmp/s.py \
    --mode paper --broker replay --symbols sh600000,sz600036 --duration 30s

# 3) qmt 实盘 (需配 broker=qmt + market_broker=qmt_market + gateway_options)
hamuna_quant_cli live run /tmp/s.py \
    --mode broker_live --broker qmt --market-broker qmt_market \
    --symbols sh600000,sz600036 \
    --gateway-options "qmt_account_id=8888888888,qmt_base_url=http://127.0.0.1:9000"

不在 hamuna-quant-cli 范畴

❌ 5m / tick / 多周期 (akquant 0.3.x Phase B 锁日线)
❌ ETF / 期权 / 期货 (akquant 仅股票)
❌ 自建回测引擎 / 私有 IR / DSL (ADR-001/002 禁止)
❌ realtime dashboard / live trading 控制台 (v2 是离线回测 + 一次性实盘 run)

关联文档

项目根: ../CLAUDE.md
v2 skill (skill 文档, 不再含代码): ../skills/hamuna-strategy-v2/SKILL.md
AKQuant Guide (引擎手册): ../docs/AKQUANT_GUIDE.md
v1 skill (旧, QMT-style 不变): ../skills/hamuna-strategy/

Metadata

Release files for hamuna-quant-cli 0.1.20

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for hamuna-quant-cli 0.1.20
File	Size	Uploaded
hamuna_quant_cli-0.1.20.tar.gz	150.9 kB	Sep 4, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for hamuna-quant-cli 0.1.20
File	Interpreter	ABI	Platform	Reset
hamuna_quant_cli-0.1.20-py3-none-any.whl 164.3 kB Sep 4, 2026	Python 3	none	any	Details

Total release size: 315.2 kB

Release files / hamuna_quant_cli-0.1.20.tar.gz

Download URL	hamuna_quant_cli-0.1.20.tar.gz
Size	150.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`6909182f864755960e63c4a3135b1aa898ba25eff3ef1e60dce6bc6b97f79c97`
BLAKE2b-256 checksum How to use checksums	`43ee8f5f98480c66fa1794d2cfb466d9828371fd167957f040dd017a11ceb301`
Upload date	Sep 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.12.13`

Release files / hamuna_quant_cli-0.1.20-py3-none-any.whl

Download URL	hamuna_quant_cli-0.1.20-py3-none-any.whl
Size	164.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`7ae0b6480c5bf694debf0672b89c53d5d7d5af1969fc966539d13f8c53b1cdd2`
BLAKE2b-256 checksum How to use checksums	`b9666932f544bf2ee29cd1032a5039acb4a2d533201b2b8c3438960aef8209fc`
Upload date	Sep 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.12.13`