algo-setup

OpenAlgo のデュアルモード取引戦略を構築・実行するためのローカル Python 環境をセットアップします。

引数

$0（任意）= Python インタープリター名（python、python3、python3.12）。デフォルト：python。

実行内容

1. OS を検出します（Windows／macOS／Linux）。uname -s または os.name を使用します。TA-Lib C ライブラリ（pip install ta-lib が依存するライブラリ）のインストールには、OS に応じたコマンドを使用します。

2. まだ存在しない場合は venv を作成します：

   python -m venv venv
   

3. TA-Lib C ライブラリをインストールします（Python の ta-lib に必要です）：

   • macOS：brew install ta-lib
   • Ubuntu/Debian：sudo apt install libta-lib-dev（sudo apt update が必要な場合があります）
   • Windows：pip install ta-lib はビルド済みホイールを使用するため、C ライブラリのインストールは不要です

4. venv を有効化して、Python パッケージを requirements.txt からインストールします：

   # Linux/macOS
   source venv/bin/activate
   pip install -r requirements.txt
   
   # Windows
   venv\Scripts\activate
   pip install -r requirements.txt
   

5. フォルダーを作成します：

   strategies/
       (empty - generated strategies will land here)
   backtests/
       (empty - generated backtest CSV/HTML output lands here)
   

6. .env.sample をコピーして .env を作成し、OPENALGO_API_KEY を入力するようユーザーに促します：

   cp .env.sample .env
   

7. 次のコマンドを実行して インストールを検証します：

   from openalgo import api, ta
   import vectorbt as vbt
   import talib
   import sklearn
   import xgboost
   print("OK")
   

8. 次の手順を表示します：

   Setup complete. Next:
     1. Edit .env and set OPENALGO_API_KEY
     2. Make sure OpenAlgo is running at http://127.0.0.1:5000
     3. Generate a strategy: /algo-strategy ema-crossover SBIN NSE 5m
   

避けること

• 出力にアイコンや絵文字を使用しないでください
• シェルで OPENALGO_API_KEY=... を自動実行しないでください。ユーザーが手動で .env に貼り付けます
• ステップ 4 以降で venv の外に pip があると想定しないでください。必ず先に venv を有効化してください

ユーザーがすでに venv を持っている場合

ステップ 2 をスキップします。既存の venv を有効化し、それに対して pip install -r requirements.txt を実行してから続行します。

失敗する場合

• Linux で TA-Lib のインストールに失敗する場合：sudo apt update && sudo apt install build-essential libta-lib-dev を実行するようユーザーに伝えてください。それでも失敗する場合（古いディストリビューションなど）は、TA-Lib をスキップし、戦略で INDICATOR_LIB="openalgo" のみを使用するよう提案してください。
• OpenAlgo が起動していない場合：セットアップは完了しますが、インストール検証ステップの from openalgo import api は動作します（SDK はネットワーク接続なしでインストールされます）。実際の接続は /algo-strategy で検証します。