Skip to content

"Vibe-Trading: Your Personal Trading Agent"

feat(providers): add ModelScope as an OpenAI-compatible provider

yrkeeaefe9e192e
diff --git a/README.md b/README.md
index 4a1699d2a..178a28bd7 100644
--- a/README.md
+++ b/README.md
@@ -640,7 +640,7 @@ vibe-trading-mcp # start MCP server (stdio)
- **Docker** for Path A
- OpenAI Codex can also be used with ChatGPT OAuth: set `LANGCHAIN_PROVIDER=openai-codex`, then run `vibe-trading provider login openai-codex`. This does not use `OPENAI_API_KEY`.
-> **Supported LLM providers:** OpenRouter, Requesty, OpenAI, Anthropic (native Messages API), DeepSeek, Gemini, Groq, DashScope/Qwen, Zhipu, Moonshot/Kimi, MiniMax, SiliconFlow (CN + Global), Xiaomi MIMO, iFlytek Spark, Z.ai, NVIDIA NIM, Ollama (local). When no `*_BASE_URL` is set, each provider falls back to its canonical endpoint, so just a key is enough. See `.env.example` for config.
+> **Supported LLM providers:** OpenRouter, Requesty, OpenAI, Anthropic (native Messages API), DeepSeek, Gemini, Groq, DashScope/Qwen, Zhipu, Moonshot/Kimi, MiniMax, SiliconFlow (CN + Global), Xiaomi MIMO, iFlytek Spark, Z.ai, NVIDIA NIM, ModelScope, Ollama (local). When no `*_BASE_URL` is set, each provider falls back to its canonical endpoint, so just a key is enough. See `.env.example` for config.
> **Tip:** All markets work without any API keys thanks to automatic fallback. yfinance (HK/US), OKX (crypto), mootdx (A-shares, TCP-direct, no IP throttle), and AKShare (A-shares, US, HK, futures, forex) are all free. Tushare token is optional — mootdx is the preferred no-token A-share fallback, with AKShare as a broader backup.
diff --git a/README_ar.md b/README_ar.md
index 99b291469..c33c2cf0e 100644
--- a/README_ar.md
+++ b/README_ar.md
@@ -637,7 +637,7 @@ vibe-trading-mcp # start MCP server (stdio)
- **Docker** للمسار A
- يمكن استخدام OpenAI Codex أيضاً عبر ChatGPT OAuth: اضبط `LANGCHAIN_PROVIDER=openai-codex`، ثم شغل `vibe-trading provider login openai-codex`. هذا لا يستخدم `OPENAI_API_KEY`.
-> **مزودو LLM المدعومون:** OpenRouter, Requesty, OpenAI, Anthropic (Messages API الأصلي), DeepSeek, Gemini, Groq, DashScope/Qwen, Zhipu, Moonshot/Kimi, MiniMax, SiliconFlow (CN + Global), Xiaomi MIMO, iFlytek Spark, Z.ai, NVIDIA NIM, Ollama (local). عند عدم ضبط أي `*_BASE_URL`، يتراجع كل مزوّد إلى نقطة نهايته القانونية، فيكفي مفتاح واحد. راجع `.env.example` للإعداد.
+> **مزودو LLM المدعومون:** OpenRouter, Requesty, OpenAI, Anthropic (Messages API الأصلي), DeepSeek, Gemini, Groq, DashScope/Qwen, Zhipu, Moonshot/Kimi, MiniMax, SiliconFlow (CN + Global), Xiaomi MIMO, iFlytek Spark, Z.ai, NVIDIA NIM, ModelScope, Ollama (local). عند عدم ضبط أي `*_BASE_URL`، يتراجع كل مزوّد إلى نقطة نهايته القانونية، فيكفي مفتاح واحد. راجع `.env.example` للإعداد.
> **نصيحة:** تعمل كل الأسواق دون مفاتيح API بفضل fallback التلقائي. yfinance (HK/US)، وOKX (crypto)، وmootdx (أسهم A، اتصال TCP مباشر بدون قيود IP)، وAKShare (A-shares, US, HK, futures, forex) كلها مجانية. رمز Tushare اختياري — mootdx هو الـ fallback الموصى به لأسهم A بدون رمز، بينما يوفر AKShare احتياطياً أوسع تغطية.
diff --git a/README_ja.md b/README_ja.md
index 6a5dacd69..cb8ec857d 100644
--- a/README_ja.md
+++ b/README_ja.md
@@ -637,7 +637,7 @@ vibe-trading-mcp # start MCP server (stdio)
- Path A では **Docker**
- OpenAI Codex は ChatGPT OAuth でも利用できます。`LANGCHAIN_PROVIDER=openai-codex` を設定し、`vibe-trading provider login openai-codex` を実行してください。`OPENAI_API_KEY` は使いません。
-> **Supported LLM providers:** OpenRouter、Requesty、OpenAI、Anthropic(ネイティブ Messages API)、DeepSeek、Gemini、Groq、DashScope/Qwen、Zhipu、Moonshot/Kimi、MiniMax、SiliconFlow(CN + Global)、Xiaomi MIMO、iFlytek Spark、Z.ai、NVIDIA NIM、Ollama(local)。`*_BASE_URL` が未設定の場合、各プロバイダーは canonical なエンドポイントにフォールバックするため、key だけで十分です。設定は `.env.example` を参照してください。
+> **Supported LLM providers:** OpenRouter、Requesty、OpenAI、Anthropic(ネイティブ Messages API)、DeepSeek、Gemini、Groq、DashScope/Qwen、Zhipu、Moonshot/Kimi、MiniMax、SiliconFlow(CN + Global)、Xiaomi MIMO、iFlytek Spark、Z.ai、NVIDIA NIM、ModelScope、Ollama(local)。`*_BASE_URL` が未設定の場合、各プロバイダーは canonical なエンドポイントにフォールバックするため、key だけで十分です。設定は `.env.example` を参照してください。
> **Tip:** 自動フォールバックにより、すべての市場は API key なしで利用できます。yfinance(HK/US)、OKX(crypto)、mootdx(A 株、TCP 直結で IP 制限なし)、AKShare(A-shares、US、HK、futures、forex)はすべて無料です。Tushare token は任意で、A 株は mootdx が推奨の no-token fallback、AKShare がより広いカバレッジのバックアップになります。
diff --git a/README_ko.md b/README_ko.md
index 80f591d0a..85dce12cf 100644
--- a/README_ko.md
+++ b/README_ko.md
@@ -637,7 +637,7 @@ vibe-trading-mcp # start MCP server (stdio)
- 경로 A용 **Docker**
- OpenAI Codex도 ChatGPT OAuth로 사용할 수 있습니다. `LANGCHAIN_PROVIDER=openai-codex`를 설정한 뒤 `vibe-trading provider login openai-codex`를 실행하세요. 이 방식은 `OPENAI_API_KEY`를 사용하지 않습니다.
-> **지원 LLM provider:** OpenRouter, Requesty, OpenAI, Anthropic (native Messages API), DeepSeek, Gemini, Groq, DashScope/Qwen, Zhipu, Moonshot/Kimi, MiniMax, SiliconFlow (CN + Global), Xiaomi MIMO, iFlytek Spark, Z.ai, NVIDIA NIM, Ollama(local). `*_BASE_URL`이 설정되지 않으면 각 provider는 canonical endpoint로 폴백하므로 key만 있으면 충분합니다. 설정은 `.env.example`을 참고하세요.
+> **지원 LLM provider:** OpenRouter, Requesty, OpenAI, Anthropic (native Messages API), DeepSeek, Gemini, Groq, DashScope/Qwen, Zhipu, Moonshot/Kimi, MiniMax, SiliconFlow (CN + Global), Xiaomi MIMO, iFlytek Spark, Z.ai, NVIDIA NIM, ModelScope, Ollama(local). `*_BASE_URL`이 설정되지 않으면 각 provider는 canonical endpoint로 폴백하므로 key만 있으면 충분합니다. 설정은 `.env.example`을 참고하세요.
> **팁:** 자동 fallback 덕분에 모든 시장은 API key 없이도 작동합니다. yfinance(HK/US), OKX(crypto), mootdx(A주, TCP 직결, IP 제한 없음), AKShare(A주, US, HK, futures, forex)는 모두 무료입니다. Tushare token은 선택 사항이며, mootdx가 권장 no-token A주 fallback이고 AKShare는 더 넓은 커버리지의 백업입니다.
diff --git a/README_zh.md b/README_zh.md
index b4822c734..7d246198d 100644
--- a/README_zh.md
+++ b/README_zh.md
@@ -634,7 +634,7 @@ vibe-trading-mcp # start MCP server (stdio)
- 路径 A 需要 **Docker**
- OpenAI Codex 也可通过 ChatGPT OAuth 使用:设置 `LANGCHAIN_PROVIDER=openai-codex`,然后运行 `vibe-trading provider login openai-codex`。它不使用 `OPENAI_API_KEY`。
-> **支持的 LLM providers:** OpenRouter、Requesty、OpenAI、Anthropic(原生 Messages API)、DeepSeek、Gemini、Groq、DashScope/Qwen、Zhipu、Moonshot/Kimi、MiniMax、SiliconFlow(CN + Global)、Xiaomi MIMO、iFlytek 星火、Z.ai、NVIDIA NIM、Ollama(本地)。未设置 `*_BASE_URL` 时,每个 provider 会回退到其规范端点,因此只需一个 key 即可。配置见 `.env.example`。
+> **支持的 LLM providers:** OpenRouter、Requesty、OpenAI、Anthropic(原生 Messages API)、DeepSeek、Gemini、Groq、DashScope/Qwen、Zhipu、Moonshot/Kimi、MiniMax、SiliconFlow(CN + Global)、Xiaomi MIMO、iFlytek 星火、Z.ai、NVIDIA NIM、ModelScope、Ollama(本地)。未设置 `*_BASE_URL` 时,每个 provider 会回退到其规范端点,因此只需一个 key 即可。配置见 `.env.example`。
> **提示:** 由于自动 fallback,所有市场都可以在没有任何 API key 的情况下工作。yfinance(港/美股)、OKX(加密)、mootdx(A 股,TCP 直连不封 IP)和 AKShare(A 股、美股、港股、期货、外汇)都是免费的。Tushare token 是可选项 —— mootdx 是首选的免 token A 股 fallback,AKShare 作为覆盖更广的兜底。
diff --git a/agent/.env.example b/agent/.env.example
index 5ee40304d..7f897a11b 100644
--- a/agent/.env.example
+++ b/agent/.env.example
@@ -119,6 +119,12 @@ OPENROUTER_BASE_URL=https://openrouter.ai/api/v1
# ZAI_API_KEY=xxx
# ZAI_BASE_URL=https://api.z.ai/api/coding/paas/v4
+# --- ModelScope ---
+# LANGCHAIN_PROVIDER=modelscope
+# LANGCHAIN_MODEL_NAME=Qwen/Qwen3.5-27B
+# MODELSCOPE_API_KEY=xxx
+# MODELSCOPE_BASE_URL=https://api-inference.modelscope.cn/v1
+
# --- Ollama (local) ---
# LANGCHAIN_PROVIDER=ollama
# LANGCHAIN_MODEL_NAME=qwen2.5:32b
diff --git a/agent/cli/_legacy.py b/agent/cli/_legacy.py
index 3ad12c04d..80e82aafe 100644
--- a/agent/cli/_legacy.py
+++ b/agent/cli/_legacy.py
@@ -425,6 +425,7 @@ def _provider_key_env(provider: str | None) -> str | None:
"spark": "SPARK_API_KEY",
"iflytek": "SPARK_API_KEY",
"zai": "ZAI_API_KEY",
+ "modelscope": "MODELSCOPE_API_KEY",
}.get((provider or "").lower())
@@ -449,6 +450,7 @@ def _provider_base_env(provider: str | None) -> str | None:
"spark": "SPARK_BASE_URL",
"iflytek": "SPARK_BASE_URL",
"zai": "ZAI_BASE_URL",
+ "modelscope": "MODELSCOPE_BASE_URL",
"ollama": "OLLAMA_BASE_URL",
}.get((provider or "").lower())
@@ -4952,6 +4954,16 @@ _PROVIDER_CHOICES: list[dict[str, str | None]] = [
"key_prefix": "sk-",
"key_placeholder": "sk-...",
},
+ {
+ "label": "ModelScope",
+ "provider": "modelscope",
+ "key_env": "MODELSCOPE_API_KEY",
+ "base_env": "MODELSCOPE_BASE_URL",
+ "base_url": "https://api-inference.modelscope.cn/v1",
+ "model": "Qwen/Qwen3.5-27B",
+ "key_prefix": None,
+ "key_placeholder": "api-key...",
+ },
{
"label": "NVIDIA NIM",
"provider": "nvidia",
diff --git a/agent/cli/onboard.py b/agent/cli/onboard.py
index 5dc1192a8..bca452d60 100644
--- a/agent/cli/onboard.py
+++ b/agent/cli/onboard.py
@@ -90,6 +90,11 @@ PROVIDERS: Final[tuple[Provider, ...]] = (
"SILICONFLOW_GLOBAL_API_KEY", "SILICONFLOW_GLOBAL_BASE_URL",
"https://api.siliconflow.com/v1", "sk-",
("deepseek-ai/DeepSeek-V3.1-Terminus",)),
+ Provider("modelscope", "ModelScope", "Alibaba's OpenAI-compatible MaaS platform",
+ "Qwen/Qwen3.5-27B",
+ "MODELSCOPE_API_KEY", "MODELSCOPE_BASE_URL",
+ "https://api-inference.modelscope.cn/v1", None,
+ ("Qwen/Qwen3.5-27B", "Qwen/Qwen3.5-397B-A17B", "Qwen/Qwen3-235B-A22B")),
Provider("nvidia", "NVIDIA NIM", "hosted NVIDIA API catalog",
"nvidia/nemotron-3-ultra-550b-a55b",
"NVIDIA_API_KEY", "NVIDIA_BASE_URL",
diff --git a/agent/src/providers/capabilities.py b/agent/src/providers/capabilities.py
index 708e61317..282b7d684 100644
--- a/agent/src/providers/capabilities.py
+++ b/agent/src/providers/capabilities.py
@@ -183,6 +183,11 @@ _PROVIDERS: dict[str, ProviderCapabilities] = {
"spark": _SPARK_CAPABILITIES,
"iflytek": _SPARK_CAPABILITIES,
"zai": ProviderCapabilities("zai", "ZAI_API_KEY", "ZAI_BASE_URL"),
+ "modelscope": ProviderCapabilities(
+ "modelscope",
+ "MODELSCOPE_API_KEY",
+ "MODELSCOPE_BASE_URL",
+ ),
"ollama": ProviderCapabilities("ollama", None, "OLLAMA_BASE_URL"),
"openai-codex": _OPENAI_CODEX_CAPABILITIES,
"openai_codex": _OPENAI_CODEX_CAPABILITIES,
diff --git a/agent/src/providers/llm_providers.json b/agent/src/providers/llm_providers.json
index ec23ed124..5ee629ef7 100644
--- a/agent/src/providers/llm_providers.json
+++ b/agent/src/providers/llm_providers.json
@@ -194,6 +194,15 @@
"default_base_url": "https://api.z.ai/api/coding/paas/v4",
"api_key_required": true
},
+ {
+ "name": "modelscope",
+ "label": "ModelScope",
+ "api_key_env": "MODELSCOPE_API_KEY",
+ "base_url_env": "MODELSCOPE_BASE_URL",
+ "default_model": "Qwen/Qwen3.5-27B",
+ "default_base_url": "https://api-inference.modelscope.cn/v1",
+ "api_key_required": true
+ },
{
"name": "ollama",
"label": "Ollama",
diff --git a/agent/tests/test_llm.py b/agent/tests/test_llm.py
index 176cfb586..cef29a70a 100644
--- a/agent/tests/test_llm.py
+++ b/agent/tests/test_llm.py
@@ -224,6 +224,15 @@ class TestSyncProviderEnv:
assert result["OPENAI_API_KEY"] == "sf-key-123"
assert result["OPENAI_API_BASE"] == base_url
+ def test_modelscope_provider(self) -> None:
+ result = self._run_sync({
+ "LANGCHAIN_PROVIDER": "modelscope",
+ "MODELSCOPE_API_KEY": "ms-key-123",
+ "MODELSCOPE_BASE_URL": "https://api-inference.modelscope.cn/v1",
+ })
+ assert result["OPENAI_API_KEY"] == "ms-key-123"
+ assert result["OPENAI_API_BASE"] == "https://api-inference.modelscope.cn/v1"
+
def test_groq_provider(self) -> None:
result = self._run_sync(
{
diff --git a/agent/tests/test_llm_provider_defaults.py b/agent/tests/test_llm_provider_defaults.py
index e48661daa..212096119 100644
--- a/agent/tests/test_llm_provider_defaults.py
+++ b/agent/tests/test_llm_provider_defaults.py
@@ -34,6 +34,7 @@ EXPECTED_PROVIDER_DEFAULTS = {
"mimo": "MiMo-72B-A27B",
"spark": "4.0Ultra",
"zai": "glm-5.1",
+ "modelscope": "Qwen/Qwen3.5-27B",
}
@@ -101,6 +102,7 @@ def test_interactive_onboard_suggests_current_primary_models() -> None:
assert onboard_defaults["deepseek"] == "deepseek-v4-pro"
assert onboard_defaults["siliconflow-cn"] == "deepseek-ai/DeepSeek-V3.1-Terminus"
assert onboard_defaults["siliconflow-global"] == "deepseek-ai/DeepSeek-V3.1-Terminus"
+ assert onboard_defaults["modelscope"] == "Qwen/Qwen3.5-27B"
assert onboard_defaults["nvidia"] == "nvidia/nemotron-3-ultra-550b-a55b"