# Reported issues for AIRAS

Pod holds 15 of 15 problems reported by people outside the maintainer team. Issues filed by the project's own owners, members and collaborators are excluded entirely — a maintainer's release checklist is not a warning to a prospective user.

Back to [AIRAS](/mcp/airas).

## Most discussed

### [Add feature] Make Langfuse tracing an optional, user-configurable integration

# 概要
現在、Langfuse連携は環境変数（`LANGFUSE_SECRET_KEY` / `LANGFUSE_PUBLIC_KEY`）が存在すると暗黙的に有効になる実装になっている。また `langfuse` パッケージは必須依存であり、Langfuseを利用しないユーザーの環境でも常にインポートされる。

Langfuseはあくまで任意（オプション）の連携として、ユーザーが明示的に設定した場合のみ有効になる実装に変更する。

# タスク
- [ ] Langfuse連携の有効/無効をユーザーが明示的に設定できるようにする（`~/.airas/credentials.json` やダッシュボードの設定画面からの opt-in）
- [ ] `langfuse` を必須依存から外すことを検討する（optional extra 化・遅延インポート）
- [ ] 未設定時にLangfuse関連のリトライ・エラーログ（SSLError / MaxRetryError 等）が一切出ないことを確認する

# 受け入れ基準
- [ ] Langfuseを設定していない環境では、連携が完全に無効

[Read the thread](https://github.com/airas-org/airas/issues/567) · 2025-12-30 · closed · 1 comment

### [Add feature]Add web search api node

I want to create a node that executes web searches using the OpenAI API.

The node should not only handle paper title retrieval but also be designed to be broadly applicable for future use cases.

It should serve as an alternative to AlexNet or web scrolling functionalities.

[Read the thread](https://github.com/airas-org/airas/issues/136) · 2025-06-06 · closed · 1 comment

### [Add feature] airasが管理するライブラリにBioNeMo (bionemo-recipes) を追加する

## 背景 / なぜ

`get_library_docs` MCP ツールが参照するライブラリレジストリ（`backend/src/airas/resources/libraries/`、現在 167 件）に NVIDIA の BioNeMo がまだ含まれていない。生命科学（タンパク質・単一細胞・ゲノム）向けのモデル学習資産であり、`science/bioinformatics` カテゴリに既にある `esm` / `openfold` / `scanpy` と同じ利用文脈で参照されるため、レジストリに載っていないとエージェントがドキュメントを引けない。

**上流の状況が変わっている点に注意**（2026-08-05 時点で実地確認）:

- リポジトリは移転かつ**リネーム**されている。`NVIDIA/bionemo-framework` と `NVIDIA-BioNeMo/bionemo-framework` は両方とも `NVIDIA-BioNeMo/bionemo-recipes` にリダイレクトする（GitHub API で同一リポジトリと確認済み）。`bionemo-

[Read the thread](https://github.com/airas-org/airas/issues/973) · 2026-08-05 · closed · 0 comments

### nemo-gym / nemo-rl をライブラリレジストリに登録する

## 背景 / なぜ

NeMo Gym を評価環境とする実験基盤を整備する方針(研究テーマは DGM 風のエージェント自己改善: https://github.com/jennyzzt/dgm )。エージェントが NeMo Gym / NeMo RL の公式ドキュメントに到達できるよう、キュレーション済みライブラリレジストリに登録する。

現状 `resources/libraries/` には `trl` / `verl` / `openrlhf`(`language/post_training.py`)、`nemo`(`systems/distributed_training.py`)はあるが、`nemo-gym` / `nemo-rl` はない。

## 利用の流れ(このレジストリがどこで参照されるか)

libraries レジストリは仮説生成ノードの入力になるものでは**ない**。MCP ツール `get_library_docs`(`backend/src/airas/mcp/server.py:706`)として MCP ホスト側のエージェントに公開され、ライブラリ名 →

[Read the thread](https://github.com/airas-org/airas/issues/962) · 2026-08-04 · closed · 0 comments

### AIXS run の成果物をリポジトリに取り込む import_run_outputs を追加する

## 背景 / なぜ

`dispatch_experiment(backend="aixs")` で実行した run の成果物が GitHub リポジトリに戻らない。AIXS はリポジトリを pull して実行するだけで push back せず（`backend/src/airas/usecases/executors/dispatch_experiment_on_aixs_subgraph/dispatch_experiment_on_aixs_subgraph.py`）、出力は作業ディレクトリから S3 にキャプチャされるだけ。一方 `fetch_experiment_results` は GitHub リポジトリを読む実装（`usecases/executors/nodes/read_run_ids.py`、`fetch_experiment_results_subgraph/nodes/fetch_results.py`）。

結果として AIXS 経路では:

- `analyze_experiment` に渡す `experimental_results` が空になる

[Read the thread](https://github.com/airas-org/airas/issues/960) · 2026-08-03 · closed · 0 comments

### acommit_multiple_files でバイナリファイルをコミットできるようにする

## 背景 / なぜ

`GithubClient.acommit_multiple_files` は `files: dict[str, str]` を受け取り、`_acreate_blob` をデフォルトの `encoding="utf-8"` のまま呼んでいる（`backend/src/airas/infra/github_client.py:1233-1259`、`:1296-1307`）。GitHub の blob API は `encoding: "base64"` を受け付け、`_acreate_blob` 自体もすでに `encoding` 引数を持っているため、**配線されていないだけ**の状態。

このためバイナリ（PNG / PDF）をリポジトリにコミットできず、以下が塞がっている:

- AIXS run の成果物（図）をリポジトリに取り込めない
- `render_chart` / `render_diagram` がローカル FS に書き出した PDF を、リモートからリポジトリにコミットできない（`backend/src/airas/mcp/server.

[Read the thread](https://github.com/airas-org/airas/issues/959) · 2026-08-03 · closed · 0 comments

### MCP サーバーの起動時 import を遅延化して起動時間を短縮する

## 背景 / なぜ

`airas.mcp.server` の import に約35秒かかり、MCP クライアントの既定の起動タイムアウト（Claude Code の場合30秒）を超えて接続に失敗する。

```
airas: uv run --directory .../backend airas - ✘ Failed to connect — connection timed out after 30000ms
```

`server.py` がすべてを top-level で import しているのが原因。`uv run` でも venv のバイナリ直叩きでも、`python -c "import airas.mcp.server"` 単体でも同じ35秒なので、起動方法ではなく import コストそのもの。

配布形態が stdio のみ（`server.py` の `mcp.run()` に transport 指定なし、`server.json` も `"transport": {"type": "stdio"}`）なので、**利用者全員が毎セッションこの35秒を支

[Read the thread](https://github.com/airas-org/airas/issues/958) · 2026-08-03 · open · 0 comments

### airas の現行機能を README または GitHub Pages で公開する

airas が現在保有している機能を洗い出し、README もしくは GitHub Pages（Mintlify ドキュメントサイト）に公開・整理する。

- 提供中の MCP ツール／research process の一覧化
- ユーザーが参照しやすい形で機能一覧を掲載
- README と docs の内容の整合を取る

[Read the thread](https://github.com/airas-org/airas/issues/952) · 2026-07-24 · open · 0 comments

## Most recent

### Add AIRAS-specific knowledge notes registry (list_domain_knowledge / get_domain_knowledge MCP tools)

## Summary

Deferred from PR #924 (which now ships only the library docs registry / `get_library_docs`). This item is the AIRAS-pipeline-specific knowledge registry: original engineering quick-reference notes served to agents via key-free MCP tools.

## What it is

- `backend/src/airas/resources/knowledge/` — Markdown notes with YAML frontmatter (`name` / `description` / `category` / `tags` / `sources` / `updated`), auto-discovered by a loader at import time (adding a note = adding a file, no co

[Read the thread](https://github.com/airas-org/airas/issues/925) · 2026-07-20 · open · 0 comments

### Implement API key management and plan-specific configurations

## 概要
APIキーの管理機能（保存・一覧表示・削除）の実装、および提供する各プラン（Self-host、Free、Pro）に応じた設定項目、実験の実行環境、データの保存先を適切に分岐・処理するための実装を行います。

## タスク
- **APIキー管理機能の実装**
  - [ ] APIキーの保存、一覧表示、削除機能の実装
  - [ ] 設定したAPIキーが実際の実行処理に使われる仕組みの構築と動作確認
- **Freeプランの実行制限の実装**
  - [ ] Freeプランにおいて、APIキーが未設定の場合は実行をブロックする処理の追加
- **設定ごとの機能・画面の構築**
  - [ ] **Self-host環境**
    - 設定項目：LLMのAPI key、GitHubのトークンを追加
    - 実験実行：GitHub Actionsを利用する仕組みの構築（主に方法の記載・ドキュメント化）
    - データ保存：ローカルに保存される仕組みの構築
  - [ ] **Freeプラン**
    - 設定項目：LLMのAPI keyを追加
    - 実験実行

[Read the thread](https://github.com/airas-org/airas/issues/853) · 2026-03-17 · closed · 0 comments

### [Add feature] Update to allow external selection of github actions agent

## 概要
GitHub Actions内で実行するAIコーディングツール（`claude code` や `open code` など）を、パラメータや環境変数で動的に指定できるように変更します。
指定がない場合は、デフォルトで `claude code` が使用されるように設定します。

## タスク
- [x] GitHub Actions ワークフロー（`.github/workflows/xxx.yml`）の `inputs` または環境変数定義に、サービス指定用のパラメータを追加する
- [x] 実行スクリプトまたはワークフロー内の条件分岐において、指定されたサービス（`claude code` / `open code` 等）に応じて実行コマンドを切り替えるロジックを実装する
- [x] パラメータが未指定（空）の場合に `claude code` をデフォルト値として適用する処理を追加する
- [x] 異なるサービスを指定してワークフローを実行し、挙動を確認する

## 受け入れ基準
- [x] パラメータを指定せずに実行した場合、自動的に `claude code` 

[Read the thread](https://github.com/airas-org/airas/issues/661) · 2026-02-03 · closed · 0 comments

### [Add feature] Enable Langfuse logging for OpenCode with external multi-provider model support

## 概要
GitHub Actions上で実行するエージェントツールをClaudeCodeからOpenCodeへ変更します。
これに伴い、OpenCodeによるLLMの利用状況（ログ、トークン消費量、コスト）をLangfuseに確実に送信・紐付けられるように設定を行います。

本実装では、特定のモデルに依存せず、**外部からモデルを指定できる設計**とし、**OpenAIやGeminiなど複数のプロバイダー**に対応できるようにします。これにより、プロジェクトの状況に合わせて柔軟にモデルを切り替えつつ、コストを一元管理することを目指します。

## タスク

*   **OpenCodeのセットアップとモデル外部指定の実装**
    *   実行時に外部（引数や環境変数など）から使用するモデルを指定できる仕組みを構築する。
    *   OpenAIやGeminiなど、主要な複数プロバイダー経由での実行が可能であることを確認する。
*   **Langfuse連携の実装**
    *   OpenCodeとLangfuseを紐づけ、トレース情報が送信されるように設定する。
  

[Read the thread](https://github.com/airas-org/airas/issues/533) · 2025-12-11 · closed · 0 comments

### [Add feature] Create code integration without Devin

**Is your feature request related to a problem? Please describe.**
The problem is that you need Devin API key for running.

**Describe the solution you'd like**
Using Openhands, Openmanus or other Agentic coding system for code integration.

[Read the thread](https://github.com/airas-org/airas/issues/194) · 2025-06-26 · closed · 0 comments

### [Add feature] Enable retrieval of module execution results locally, not just via GitHub upload

Currently, only the following output can be obtained.
```bash
result: {'github_upload_success': True}
```

**Feature Request:**
Support returning the updated `research_history.json` along with related GitHub metadata in the response.

[Read the thread](https://github.com/airas-org/airas/issues/17) · 2025-05-01 · closed · 0 comments

### [Add feature] MCP support

Add docstring for use as an MCP server.

[Read the thread](https://github.com/airas-org/airas/issues/14) · 2025-05-01 · closed · 0 comments

The remaining reports are on [the project's issue tracker](https://github.com/airas-org/airas/issues).