# ValueCell
## 產品已上線 🔥🔥🔥
**ValueCell 現已提供 A 股深度研究與市場分析，且無需部署——直接造訪 [valuecell.ai](https://valuecell.ai)。**
## 簡介
ValueCell 是一個社群驅動的多智能體金融應用平台，我們的使命是打造世界最大的去中心化金融智能體社群。
它會為您提供頂尖的投資智能體團隊，協助您完成選股、調研、追蹤，甚至交易。
系統會將您的敏感資訊完全託管在本地，確保核心資料安全。
歡迎大家加入 Discord 社群回饋使用中遇到的問題，並邀請更多開發者參與共建 🔥🔥🔥
>注意：ValueCell團隊人員不會主動私信社群參與者，項目僅為技術交流使用，投資有風險。⚠️
# 產品截圖
[](https://www.youtube.com/watch?v=C3tfHyGY9YE)
# 核心功能
## 多智能體系統
- **DeepResearch Agent**：獲取並分析股票的基本面文件，輸出準確的數據與可解釋的總結
- **Strategy Agent**：支援多種加密資產、多策略智慧交易，自動執行你的策略
- **News Retrieval Agent**: 支援個人化定時任務的新聞推送，及時追蹤關鍵資訊
- **其他智能體**：更多智能體正在規劃中...
## 彈性整合
- **多家大型語言模型供應商**：支援 OpenRouter、SiliconFlow、Openai-compatible、Azure、Google、OpenAI 與 DeepSeek
- **熱門市場資料**：涵蓋美國市場、加密貨幣、香港市場、中國市場等
- **多智能體框架相容**：透過 A2A 協議，支援 LangChain、Agno 等主流 Agent 框架，進行研發整合
- **交易所連接**：支援即時路由至 OKX 和 Binance，並內建安全防護機制
# 快速開始
## 新使用者
若要快速開始使用，請從 GitHub 的[發布頁面](https://github.com/ValueCell-ai/valuecell/releases)下載適用於 MacOS 或 Windows 的最新 ValueCell 應用程式。
安裝後，使用 ValueCell 前請先設定您偏好的模型供應商。請參閱應用程式內的指示或文件。
### 即時交易
- 配置 AI 模型: 透過網頁介面新增你的 AI 模型 API Key。
- 配置交易所: 設定 Binance/HyperLiquid/OKX/Coinbase... API 憑證
- 建立策略: 將 AI 模型與交易所組合，建立自訂交易策略
- 監控與控制: 透過即時監控啟動/停止策略，並監控交易表現
- 注意：當前僅支援合約交易（現貨以1X合約實現），所以請確保合約帳戶存在餘額
#### 支援的交易所
| 交易所 | 說明 | 狀態 |
| --- | --- | --- |
| **Binance** | 僅支援國際站 [binance.com](binance.com)，不支援美國站。使用 USDT-M 合約（USDT 本位合約）。請確保您的合約帳戶有足夠的 USDT 餘額。交易對格式：`BTC/USDT`。 Note：確保永續合約帳戶不為0。 申請API添加IP白名單通過搜索引擎搜索`My IP`查看 | ✅ 已測試 |
| **Hyperliquid** | 僅支援 USDC 作為保證金貨幣。使用您的主錢包地址 + API 錢包私鑰認證（使用 [API 頁面](https://app.hyperliquid.xyz/API) 申請）。市價單會自動轉換為 IoC 限價單。交易對格式必須手動調整為 `SYMBOL/USDC`（例如 `WIF/USDC`）配置地址為主錢包地址+API錢包私鑰 每次交易至少10U | ✅ 已測試 |
| **OKX** | 需要 API Key、Secret 和 Passphrase（OKX帳號密碼） 進行認證。支援 USDT 本位合約。交易對格式：`BTC/USDT`。 | ✅ 已測試 |
| Coinbase | 支援 USDT 本位合約。Coinbase International 尚未支援 | 🟡 部分測試 |
| Gate.io | 支援 USDT 本位合約。需要 API Key 和 Secret | 🟡 部分測試 |
| MEXC | 支援 USDT 本位合約。需要 API Key 和 Secret | 🟡 部分測試 |
| Blockchain | 支援 USDT 本位合約。需要 API Key 和 Secret | 🟡 部分測試 |
**圖例**:
- ✅ **已測試**: 在生產環境中經過充分測試和驗證
- 🟡 **部分測試**: 程式碼實作已完成但未完全測試，可能需要除錯
- **推薦**: 優先使用經過充分測試的交易所（Binance, Hyperliquid, OKX）
### 注意事項
- 目前僅支援槓桿/合約交易，因此您需要確保您的永續合約（Perps）帳戶有足夠的餘額。
- 您必須妥善保管您的 API 密鑰以避免資金損失。該應用程式將密鑰本地儲存在您的裝置上，不會透過網際網路發送給任何第三方。
- 為了確保您的帳戶安全，您需要定期重設您的 API 密鑰。
---
**注意**：啟動應用程式前，請確認所有前置條件已安裝且環境變數正確設定。
若長時間未有更新，可以刪除本地資料並重新啟動：
- LanceDB 目錄（位於系統應用程式目錄，與 `.env` 同路徑）：
- macOS: `~/Library/Application Support/ValueCell/lancedb`
- Linux: `~/.config/valuecell/lancedb`
- Windows: `%APPDATA%\\ValueCell\\lancedb`
- 知識目錄（位於系統應用程式目錄，與 `.env` 同路徑）：
- macOS: `~/Library/Application Support/ValueCell/.knowledge`
- Linux: `~/.config/valuecell/.knowledge`
- Windows: `%APPDATA%\\ValueCell\\.knowledge`
- SQLite 資料庫檔案（位於系統應用程式目錄，與 `.env` 同路徑）：
- macOS: `~/Library/Application Support/ValueCell/valuecell.db`
- Linux: `~/.config/valuecell/valuecell.db`
- Windows: `%APPDATA%\\ValueCell\\valuecell.db`
## 開發者
誠摯邀請每位開發者加入 Discord 討論組，我們會定期交流社群 RoadMap 以及未來社群貢獻者權益規劃
開發流程及標準詳見:[CONTRIBUTING.md](.github/CONTRIBUTING.md)
ValueCell 是一個基於Python的應用程式，且有完備的前端操作頁面，支援多端應用。可以參考下面配置快速運行。
## 克隆倉庫
```bash
git clone https://github.com/ValueCell-ai/valuecell.git
cd valuecell
```
## 啟動應用程式
啟動完整應用程式（前端、後端與智能體）：
### Linux / Macos
```bash
bash start.sh
```
### Windows (PowerShell)
```powershell
.\start.ps1
```
### 存取介面
- **Web UI**：於瀏覽器開啟 [http://localhost:1420](http://localhost:1420)
- **日誌**：在終端即可查看應用程式日誌，追蹤後端服務與各智能體的詳細執行資訊
### 下一步
應用程式啟動後，你可以透過網頁介面探索並使用 ValueCell 的各項功能與能力
### 設定
更多系統設定詳情說明可以參考[CONFIGURATION_GUIDE](./docs/CONFIGURATION_GUIDE.md)
# 路線圖
## 🤖 強化智能體能力
### 交易能力
- **加密貨幣**：支援 OKX、Binance、Hyperliquid交易所，更多交易所規劃接入中…
- **證券**：逐步支援 AI 證券交易
### 市場擴展
- **歐洲市場**：新增對富時指數、DAX、CAC 40 與其他歐洲交易所的支援
- **亞洲市場**：擴展對日經指數與新興亞洲市場的覆蓋
- **大宗商品市場**：石油、黃金、白銀與農產品分析
- **外匯市場**：主要貨幣對與交叉貨幣分析
### 資產類別多樣化
- **固定收益**：政府債券、企業債券與殖利率分析智能體
- **衍生性商品**：選擇權、期貨與複雜金融工具
- **另類投資**：民間股權、對沖基金與風險投資分析
### 高級通知與推送類型
- **即時警示**：價格波動、成交量激增與技術突破
- **定期報告**：每日／每週／每月投組摘要
- **事件驅動通知**：財報發布、股息公告、監管變動
- **自訂觸發器**：使用者自定義條件與閾值
- **多通道推送**：Discord 與 webhook 整合
## ⚙️ 產品設定與個人化
### 多端產品化
- **客戶端支援**：逐步支援桌面端、客戶端能力
- **資料庫熱更新**：逐步支援相容性升級
### 國際化 (i18n)
- **多語系支援**：英文、中文（簡體／繁體）、日文、韓文、西班牙文、法文
- **在地化市場資料**：特定地區的金融術語與格式
- **文化適配**：時區、日期格式與貨幣偏好
- **智能體個性在地化**：符合文化的溝通風格
### 令牌與認證管理
- **API 金鑰管理**：第三方 API 金鑰的安全儲存與輪換
- **OAuth 整合**：支援主要金融資料供應商
### 使用者偏好與自訂
- **投資檔案**：風險承受度、投資期間與策略偏好
- **UI/UX 自訂**：深色／淺色模式、儀表板佈局與元件偏好
- **智能體行為**：溝通頻率、分析深度與報告風格
- **投組管理**：自訂基準、效能指標與目標設定
### 記憶與學習系統
- **對話歷史**：跨會話的持久聊天記錄
- **使用者學習**：根據使用者行為的自適應推薦
- **市場記憶**：歷史背景與模式識別
- **偏好演進**：推薦的動態調整
## 🔧 ValueCell SDK 開發
### 核心 SDK 功能
- **Python SDK**：用於智能體整合與客製的核心程式，連接前後端
- **WebSocket 支援**：即時資料串流與雙向通訊
### 智能體整合框架
- **外掛架構**：輕鬆整合第三方智能體與工具
- **智能體註冊表**：社群貢獻智能體的市集
### 開發者工具與文件
- **互動式 API 瀏覽器**：含即時測試的 Swagger/OpenAPI 文件
- **程式範例**：多種程式語言的範例實作
- **測試框架**：單元測試、整合測試與模擬資料提供者
# 授權條款
本專案依據 **Apache License 2.0** 授權發布；詳情請參閱 `LICENSE` 檔案。
> 📌 注意：Apache 2.0 僅適用於由 ValueCell 團隊與貢獻者撰寫的原始程式碼。第三方元件（如 API、掛件、函式庫）受其各自的授權與使用條款約束——詳見下方。
## 第三方元件與授權
ValueCell 整合外部服務並嵌入第三方掛件。其使用不受 Apache 2.0 覆蓋，遵循其服務條款的合規責任由使用者／開發者自行承擔。
| 元件 | 類型 | 授權 / 條款 |
|---------|------|-----------------|
| **TradingView Advanced Chart** | 嵌入式 iframe 掛件 | [Free Advanced Charts Agreement](https://www.tradingview.com/chart-embedding/)（專有） |
| **交易所 API**（Binance、OKX、Hyperliquid 等） | REST/WebSocket 端點 | 各交易所的服務條款（例如 [Binance API 條款](https://www.binance.com/en/terms)） |
| **LLM 供應商**（OpenAI、Azure、Google、DeepSeek 等） | 推論 API | 供應商特定的使用條款（例如 [OpenAI 使用條款](https://openai.com/policies/terms-of-use)） |
# Star
