README.md

Robin Materials: 材料科学研究のためのマルチエージェントシステム #

材料科学研究と開発を自動化するためのマルチエージェントシステムです。シラスガラス薄膜の細孔径制御、新素材開発、材料特性解析などの材料工学研究を支援します。

機能 #

  • 実験手法生成: 材料研究に最適な実験手法の提案とランキング
  • 材料候補生成: 特定の用途に適した新材料候補の提案
  • 文献調査: 材料科学分野の最新研究動向の自動調査
  • データ解析: 実験データの解析と洞察の抽出

前提条件 #

  • Python: バージョン3.12以上
  • API キー:
    • FUTUREHOUSE_API_KEY: FutureHouseプラットフォームエージェント(Crow、Falcon)へのアクセス用
    • GEMINI_API_KEY: Google Geminiモデルへのアクセス用(必須)
    • OPENAI_API_KEY: OpenAIモデルへのアクセス用(オプション)
    • "Finch"(データ解析)部分はFutureHouseプラットフォームのクローズドベータへのアクセスが必要です

セットアップ手順 #

  1. リポジトリのクローン:

    git clone https://github.com/Future-House/robin-materials.git
    cd robin-materials
    
  2. API キーの取得:

    Google Gemini API Key (必須):

    • Google AI Studioにアクセス
    • Googleアカウントでログイン
    • "Get API key"をクリックしてAPIキーを取得
    • またはGoogle Cloud ConsoleでVertex AI APIを有効化してAPIキーを生成

    FutureHouse API Key (必須):

    • FutureHouseでアカウントを作成
    • APIキーを取得
  3. 環境変数の設定:

    プロジェクトルートに.envファイルを作成し、以下の内容を追加:

    # Google Gemini API Key (必須)
    GEMINI_API_KEY=your_gemini_api_key_here
    
    # FutureHouse API Key (必須)
    FUTUREHOUSE_API_KEY=your_futurehouse_api_key_here
    
    # OpenAI API Key (オプション)
    OPENAI_API_KEY=your_openai_api_key_here
    
  4. Dockerを使用した実行(推奨):

    docker-compose up --build
    
  5. ローカル環境での実行:

    # 仮想環境の作成とアクティベート(推奨):
    uv venv .venv
    source .venv/bin/activate
    

    または

    python3 -m venv .robin_env
    source .robin_env/bin/activate
    
  6. 依存関係のインストール: プロジェクトはpyproject.tomlを使用して依存関係を管理します:

    uv pip install -e '.[dev]'
    

    または

    pip install -e '.[dev]'
    

Robin Materialsの実行 #

robin_materials_demo.ipynbを使用した実行 #

  1. Jupyter NotebookまたはJupyterLabの起動: ターミナルでrobinディレクトリに移動し(仮想環境がアクティブであることを確認)、以下を実行:

    jupyter notebook
    # または
    jupyter lab
    
  2. ノートブックの開く: Jupyterインターフェースでrobin_materials_demo.ipynbを開く

  3. Robinの設定: RobinConfigurationオブジェクトが作成されるセルを探す:

    config = RobinConfiguration(
        material_name="MATERIAL_NAME",  # <-- 材料名をここでカスタマイズ
        research_focus="RESEARCH_FOCUS",  # <-- 研究焦点を設定
        target_application="TARGET_APPLICATION"  # <-- 目標応用を設定
    )
    
    • material_nameの変更: "MATERIAL_NAME"を対象材料に変更
    • research_focusの設定: 研究の焦点領域を指定
    • target_applicationの設定: 目標とする応用分野を指定
    • API キー: 環境変数として設定済みのため、自動的に読み込まれます
  4. ノートブックセルの実行: ノートブックのセルを順次実行。ノートブックは以下の構造になっている:

    • 実験手法生成: 潜在的な実験手法の生成とランキング
    • 材料候補生成: トップ手法に基づく材料候補の生成とランキング
    • (オプション)実験データ解析: 実験データがある場合、このセクションでデータを解析し、候補生成に洞察をフィードバック

材料科学研究の例 #

シラスガラス薄膜の細孔径制御 #

config = RobinConfiguration(
    material_name="シラスガラス薄膜",
    research_focus="細孔径制御",
    target_application="分離膜、触媒担体、薬物送達システム"
)

その他の材料研究例 #

  • 新素材開発: 軽量高強度材料、導電性材料、生体適合材料
  • 材料特性解析: 機械的特性、電気的特性、熱的特性の測定手法
  • 製造プロセス最適化: 薄膜形成、焼結、表面処理の最適化
  • 材料設計: 合金設計、複合材料設計、ナノ材料設計

期待される出力 #

  • ログ: 各ステップの進行状況を示す詳細なログがノートブック出力やコンソールに表示
  • ファイル: 結果はrobin_output/内の新しいサブディレクトリに保存(例:robin_output/シラスガラス薄膜_YYYY-MM-DD_HH-MM/)

高度な使用法 #

完全な例はrobin_full.ipynbノートブックにあります。このノートブックには、論文で使用されたパラメータとエージェントが含まれています。

robinPythonモジュール(robin/ディレクトリ内)をインポートして、その関数(experimental_assay、therapeutic_candidates、data_analysis)を独自のPythonスクリプトでプログラム的に使用することも可能です。

材料科学分野での応用 #

  • セラミックス材料: シラスガラス、ジルコニア、アルミナ
  • 金属材料: 合金設計、表面処理、腐食防止
  • 高分子材料: 生分解性材料、導電性高分子、複合材料
  • ナノ材料: カーボンナノチューブ、グラフェン、量子ドット
  • 生体材料: 生体適合性材料、組織工学材料、薬物送達システム

セキュリティ #

  • APIキーは.envファイルに保存され、Gitにコミットされません
  • .env.exampleファイルをテンプレートとして使用してください
  • 本番環境では、より安全なシークレット管理システムの使用を推奨します