Something went wrong. Try again.
[READ-ONLY] Mirror of https://github.com/takeruhukushima/robin-material.
Something went wrong. Try again.
Files
- Python 58%
- Jupyter Notebook 42%
- Docker <1%
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プラットフォームのクローズドベータへのアクセスが必要です
セットアップ手順 #
-
リポジトリのクローン:
git clone https://github.com/Future-House/robin-materials.git cd robin-materials -
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キーを取得
-
環境変数の設定:
プロジェクトルートに
.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 -
Dockerを使用した実行(推奨):
docker-compose up --build -
ローカル環境での実行:
# 仮想環境の作成とアクティベート(推奨): uv venv .venv source .venv/bin/activateまたは
python3 -m venv .robin_env source .robin_env/bin/activate -
依存関係のインストール: プロジェクトは
pyproject.tomlを使用して依存関係を管理します:uv pip install -e '.[dev]'または
pip install -e '.[dev]'
Robin Materialsの実行 #
robin_materials_demo.ipynbを使用した実行 #
-
Jupyter NotebookまたはJupyterLabの起動: ターミナルで
robinディレクトリに移動し(仮想環境がアクティブであることを確認)、以下を実行:jupyter notebook # または jupyter lab -
ノートブックの開く: Jupyterインターフェースで
robin_materials_demo.ipynbを開く -
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 キー: 環境変数として設定済みのため、自動的に読み込まれます
-
ノートブックセルの実行: ノートブックのセルを順次実行。ノートブックは以下の構造になっている:
- 実験手法生成: 潜在的な実験手法の生成とランキング
- 材料候補生成: トップ手法に基づく材料候補の生成とランキング
- (オプション)実験データ解析: 実験データがある場合、このセクションでデータを解析し、候補生成に洞察をフィードバック
材料科学研究の例 #
シラスガラス薄膜の細孔径制御 #
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ファイルをテンプレートとして使用してください- 本番環境では、より安全なシークレット管理システムの使用を推奨します