# 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**: パーソナライズされた定時ニュース配信に対応し、重要情報をタイムリーに追跡します
- **その他**: さらに多くのエージェントを計画中...
## 柔軟な統合
- **複数のLLMプロバイダー**: OpenRouter、SiliconFlow、Azure、Openai-compatible、Google、OpenAIおよびDeepSeekをサポート
- **人気の市場データ**: 米国市場、暗号市場、香港市場、中国市場など
- **マルチエージェントフレームワーク対応**: A2AプロトコルによるLangchain、Agnoをサポート、研究開発の統合を行う
- **取引所接続**: OKX と Binance へのリアルタイムルーティングに対応し、安全ガードレールを内蔵
# クイックスタート
## 新規ユーザー向け
最新の ValueCell アプリケーション（MacOS または Windows 用）を GitHub の[リリースページ](https://github.com/ValueCell-ai/valuecell/releases)からダウンロードできます。
インストール後、初回使用時に、お好みのモデルプロバイダーを設定してください。アプリケーション内の指示またはドキュメントを参照してください。
### ライブ取引
- AIモデルの設定: Webインターフェースから AI モデルの API キーを追加します。
- 取引所の設定: Binance/HyperLiquid/OKX/Coinbase... の API 認証情報を設定します。
- ストラテジー作成: AIモデルと取引所を組み合わせてカスタム戦略を作成します。
- モニタリング＆コントロール: 戦略の開始／停止を行い、パフォーマンスをリアルタイムで監視します。
- 注意：現在は先物取引のみをサポートしています（現物は1X先物として実装）。先物口座に十分な残高があることを確認してください
#### サポートされている取引所
| 取引所 | 備考 | ステータス |
| --- | --- | --- |
| **Binance** | 国際サイト [binance.com](binance.com) のみサポート（米国サイトは非対応）。USDT-M 先物（USDT証拠金契約）を使用します。先物口座に十分な USDT 残高があることを確認してください。取引ペア形式: `BTC/USDT`。注意：無期限先物口座の残高が0でないことを確認してください。API申請時はIPホワイトリストを追加してください（検索エンジンで`My IP`を検索して確認） | ✅ テスト済み |
| **Hyperliquid** | 証拠金通貨として USDC のみサポートします。メインウォレットアドレス + API ウォレット秘密鍵認証を使用します（[APIタブ](https://app.hyperliquid.xyz/API)から申請）。成行注文は自動的に IoC 指値注文に変換されます。取引ペア形式は手動で `SYMBOL/USDC` に調整する必要があります（例: `WIF/USDC`）。メインウォレットアドレス+APIウォレット秘密鍵で設定。1取引あたり最低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`
- Knowledge ディレクトリ（システムアプリディレクトリに保存。`.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は包括的なWebインターフェースを備えた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)にアクセス
- **ログ**: ターミナルで直接アプリケーションログを確認し、バックエンドサービスと個々のエージェントの詳細な実行時情報を取得
### 次のステップ
アプリケーションが起動したら、WebインターフェースでValueCellの機能を操作して探索できます。
### 設定
詳細な設定情報については、[CONFIGURATION_GUIDE](./docs/CONFIGURATION_GUIDE.md)を参照してください
# ロードマップ
## 🤖 強化されたエージェント機能
### 取引能力
- **暗号通貨**: OKX、BinanceとHyperliquid の取引所に対応、今後さらに多くの取引所を順次追加予定です…
- **証券**: AI証券取引を段階的にサポート
### 市場拡大
- **ヨーロッパ市場**: FTSE、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 History
