ページスタートガイド · 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 --versionWindows で python が認識されない場合は、次を試してください。
py --version2. QuantCraft をインストールして開く
お使いの Windows のアーキテクチャ(v1.3.0)用のインストーラーをダウンロードして実行します。
Windows(Microsoft Store、推奨)
macOS(Apple Silicon、v1.3.0)
- QuantCraft_1.3.0_aarch64.dmg.zip — ディスクイメージ(zip)
- QuantCraft.app.tar.gz — アプリバンドル(tar.gz)
その後:
- QuantCraft を起動する
- 戦略 IDE/ワークスペース領域を開く
3. 最初の戦略を作成する
.pyの戦略ファイルを作成するか、インポート する- 基本となる ライフサイクルのコールバック を追加する:
on_initon_barとon_tickon_finish- 任意の
on_timer(フォワード実行のみ — IDE のバックテストでは使えません)
- 調整可能な値のために、設定可能な
paramsを定義する
4. バックテストを実行する
Run backtest(最大 3 つのタブ)で設定します。
- Symbol & data — 価格フィード、銘柄、時間足、任意の Additional timeframes(
rt.get_bar用)、任意のファンダメンタルズ/ファクター - Simulation — 期間、ウォームアップ、初期残高、手数料/スリッページ
- Script — ファイルで宣言している場合の 入力パラメータ(
params)
Test(コードの実行)を使い、次を確認します。
エンジンが戦略をどのように動かすかは、バックテスト を参照してください。
5. セットアップが正常か確認する
次の状態であれば、セットアップは正しく完了しています。
- Python スクリプトがインポートエラーや実行時エラーなしに実行される
- バックテストが完了し、結果パネルが表示される
- 戦略のログとチャートが期待どおりの挙動と一致する
よくあるセットアップの問題
pythonが見つからない: Python を再インストールし、PATH を有効にする- モジュールのインポートエラー: 有効な環境に依存関係をインストールする
- 結果が一貫しない: 銘柄、期間、時間足、params を確認する
- 取引が生成されない: エントリー/エグジット条件と、ウォームアップ/データの有無を確認する
初心者向けのベストプラクティス
- 1 つの銘柄とシンプルな戦略から始める
- 定数はパラメータ化する(すべてをハードコードしない)
- デバッグのために主要な判断をログに記録する
- 結果を信頼する前に、複数の期間や相場環境で検証する


