ドキュメント1.0 (latest)
ページスタートガイド · 2 / 29

スタートガイド

QuantCraft は、Python の取引戦略を開発・テスト・改善するためのオールインワンのデスクトップアプリです。
このガイドでは、すばやく正しく使い始めるために必要なことだけを説明します。全体像は はじめに、IDE の領域やパネルについては ワークスペースのレイアウト をご覧ください。

前提条件

戦略機能を使う前に、次のものをインストールしてください。

  • QuantCraft デスクトップアプリ(最新の安定版)
  • Python 3.10 以上(3.11 を推奨)
  • pip(ほとんどの Python インストールに含まれています)
  • インターネット接続(パッケージのインストールや、連携するデータ/サービスのため)
  • プロジェクト、ログ、バックテスト出力のための 十分なディスク容量

1. Python をインストールする

python.org から Python をダウンロードしてインストールします。

インストール時に:

  • Add Python to PATH を有効にする

確認:

python --version pip --version

Windows で python が認識されない場合は、次を試してください。

py --version

2. QuantCraft をインストールして開く

お使いの Windows のアーキテクチャ(v1.3.0)用のインストーラーをダウンロードして実行します。

Windows(Microsoft Store、推奨)

Download from the Microsoft Store

macOS(Apple Silicon、v1.3.0)

その後:

  • QuantCraft を起動する
  • 戦略 IDE/ワークスペース領域を開く

3. 最初の戦略を作成する

  1. .py の戦略ファイルを作成するか、インポート する
  2. 基本となる ライフサイクルのコールバック を追加する:
    • on_init
    • on_bar と on_tick
    • on_finish
    • 任意の on_timer(フォワード実行のみ — IDE のバックテストでは使えません)
  3. 調整可能な値のために、設定可能な params を定義する

4. バックテストを実行する

Run backtest(最大 3 つのタブ)で設定します。

  • Symbol & data — 価格フィード、銘柄、時間足、任意の Additional timeframes(rt.get_bar 用)、任意のファンダメンタルズ/ファクター
  • Simulation — 期間、ウォームアップ、初期残高、手数料/スリッページ
  • Script — ファイルで宣言している場合の 入力パラメータ(params)

Test(コードの実行)を使い、次を確認します。

エンジンが戦略をどのように動かすかは、バックテスト を参照してください。


5. セットアップが正常か確認する

次の状態であれば、セットアップは正しく完了しています。

  • Python スクリプトがインポートエラーや実行時エラーなしに実行される
  • バックテストが完了し、結果パネルが表示される
  • 戦略のログとチャートが期待どおりの挙動と一致する

よくあるセットアップの問題

  • python が見つからない: Python を再インストールし、PATH を有効にする
  • モジュールのインポートエラー: 有効な環境に依存関係をインストールする
  • 結果が一貫しない: 銘柄、期間、時間足、params を確認する
  • 取引が生成されない: エントリー/エグジット条件と、ウォームアップ/データの有無を確認する

初心者向けのベストプラクティス

  • 1 つの銘柄とシンプルな戦略から始める
  • 定数はパラメータ化する(すべてをハードコードしない)
  • デバッグのために主要な判断をログに記録する
  • 結果を信頼する前に、複数の期間や相場環境で検証する
スタートガイド — ドキュメント (1.0 (latest)) | QuantCraft