Tracking: Migrate Agent layer to OpenAI Agents SDK
まだ誰も着手していません。
評価
- 難易度
- 5/5
- 見積もり時間
- 1週間以上
- 初心者へのやさしさ
- 25/100
調査の方向性
まずターゲットアーキテクチャと参照されているPR #61、#65、#67、#70を読み、その後、現在の brain/、tools/、flow/、llm/ の領域を調査してください。このissueは自己完結型のタスクではなく、移行トラッカーです。ロードマップの移行作業が完了した場合にのみ完了となります。
索引モデルが issue の本文から書いたものです。
説明
Motivation
QuantMind invested ~3 months building a smolagents-derived Agent runtime in PRs #61, #65, and #67 (~1900 lines of brain/ + tools/ + supporting modules). We now believe this was a wrong direction:
- Agent runtime is a commodity in 2026. OpenAI Agents SDK, smolagents, LangGraph, etc. compete on the same surface. Maintaining our own gives QuantMind no differentiation.
- It consumes engineering time that should go into financial-domain work (data schemas, e2e pipelines, research-friendly memory patterns).
This issue tracks the migration to OpenAI Agents SDK as the underlying agent runtime, with QuantMind repositioning as a domain library on top.
Architecture update (2026-07-15): Durable canonical collections and semantic indexing belong to the top-level
quantmind/library/package tracked in #111.mind/owns cognition, tools, working memory, and later tree navigation; it may consumelibrarybut does not own persistence or index lifecycle. This supersedes the vagueKnowledgeStoreplacement in the original roadmap below.
Target Architecture
quantmind/
├── flows/ # e2e processing pipelines (paper_flow, news_flow, ...)
├── knowledge/ # Pydantic-based knowledge schema standard (Paper, News, ...)
├── library/ # canonical collections + derived semantic index (#111)
├── preprocess/ # fetch (arxiv/http/doi/local) + format (pdf/html/markdown)
├── mind/ # cognition, tools, working memory, tree navigation; no persistence
├── configs/ # centralized BaseFlowCfg + per-flow cfg + input types
├── magic.py # resolve_magic_input: natural language → (input, cfg)
└── utils/ # logger only
Key principle: QuantMind does NOT rebuild Agent runtime, lifecycle hooks, tracing, multi-agent handoff, or tool framework. Those come from openai-agents.
Roadmap
- PR1 (#70): Clean removal of self-built agent runtime
- PR2:
knowledge/+configs/skeleton (Pydantic schemas + centralized cfg) - PR3:
preprocess/two-layer structure (fetch + format) - PR4:
flows/+paper_flow+batch_run+magic.py; concurrent removal offlow/andllm/ - PR5:
mind/memory/filesystemMVP + trajectory archive - PR6+: Semantic library (#111), paper-search integration (#112), PageIndex navigation (#95), additional sources, and observability cookbook
Archive
The pre-pivot agent runtime is preserved as a snapshot on the archive/agent-runtime-final branch on origin for historical reference. It will not be merged back to master.
References
- OpenAI Agents SDK docs: https://openai.github.io/openai-agents-python/
- Lifecycle / RunHooks: https://openai.github.io/openai-agents-python/ref/lifecycle/
- MCP integration (filesystem server): https://openai.github.io/openai-agents-python/mcp/
- Tracing: https://openai.github.io/openai-agents-python/tracing/
- SDK announcement: https://openai.com/index/the-next-evolution-of-the-agents-sdk/
- 主要言語
- Python
- スター
- 3.1k
- フォーク
- 492
- PR マージ指標
- 30日以内にマージされた PR はありません
環境構築
- Dockerfile・Docker Compose ファイルなし
- プルリクエストのテンプレートあり
- コントリビューションガイドを読む
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
LLMQuant/quant-mind のほかの issue
-
難易度 4/5 3〜5日 初心者へのやさしさ 35/100
LLMQuant/quant-mind#155 · コメント 2 件 ·
-
design(flows): structure tree drafted from truncated page text (1200 chars), diverging from PageIndex full-page construction再び着手できるかも @keli-wen が 80 日前に担当しましたが、オープン中のプルリクエストはありません。 オープンarea: flows area: preprocess type: design
LLMQuant/quant-mind#133 · コメント 1 件 · 担当者 1 名 ·
-
feat(flows): surface token-usage and cost for runs and batch_run対応中かも @dhruvraajeev が 81 日前に担当しました。 オープンarea: configs area: flows area: mind type: feature
難易度 5/5 1週間以上 初心者へのやさしさ 45/100
LLMQuant/quant-mind#127 · コメント 1 件 ·
-
design(config): define ownership of typed operation inputs再び着手できるかも @keli-wen が 85 日前に担当しましたが、オープン中のプルリクエストはありません。 オープンarea: flows type: feature
LLMQuant/quant-mind#121 · 担当者 1 名 ·
-
bug: exchange-qualified multi-symbol lists are only partially captured対応中かも @pengpengyi92 が 82 日前に担当しました。 オープンarea: preprocess stale type: bug
難易度 5/5 1週間以上 初心者へのやさしさ 38/100
LLMQuant/quant-mind#108 · コメント 2 件 ·
LLMQuant/quant-mind の issue をすべて見る
似ている issue
-
docs pydanty:is-working
難易度 2/5 1〜3時間 初心者へのやさしさ 68/100
pydantic/pydantic-ai#10113 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 77/100
GreedyBear-Project/GreedyBear#1727 ·
メンテナーはふだん 2 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 84/100
ARM-software/CMSIS-DSP#354 ·
-
難易度 2/5 1〜3時間 初心者へのやさしさ 68/100
kiat/codeAssist#391 ·
-
needs triage
難易度 2/5 1〜3時間 初心者へのやさしさ 83/100
darnitdevorg/darnit#587 ·
メンテナーはふだん 1 日以内に返信