Skip to content

Latest commit

 

History

History
280 lines (207 loc) · 17.3 KB

README.ja.md

File metadata and controls

280 lines (207 loc) · 17.3 KB

ValueCell

プロダクト公開 🔥🔥🔥

ValueCell は A 株のディープリサーチと市場分析を提供し、デプロイ不要で valuecell.ai から直接利用できます。

概要

ValueCell は、金融アプリケーション向けのコミュニティ主導型マルチエージェントプラットフォームです。私たちの使命は、世界最大の分散型金融エージェントコミュニティを構築することです。

トップクラスの投資エージェントチームが、銘柄選別、リサーチ、追跡、さらには取引まで支援します。

機密情報はすべてローカルデバイスに保存され、コアデータのセキュリティを確保します。

Discord コミュニティへのご参加をお待ちしています。使用中に発生した問題についてのご意見をお寄せいただき、さらに多くの開発者にご参加いただけますようお願いします 🔥🔥🔥

注意: ValueCellチームメンバーがコミュニティ参加者に主動的に連絡することはありません。このプロジェクトは技術交流のみを目的としています。投資にはリスクが伴います。⚠️

スクリーンショット

動画を観る

主な機能

マルチエージェントシステム

  • 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 のリリースページからダウンロードできます。

インストール後、初回使用時に、お好みのモデルプロバイダーを設定してください。アプリケーション内の指示またはドキュメントを参照してください。

ライブ取引

  • AIモデルの設定: Webインターフェースから AI モデルの API キーを追加します。
  • 取引所の設定: Binance/HyperLiquid/OKX/Coinbase... の API 認証情報を設定します。
  • ストラテジー作成: AIモデルと取引所を組み合わせてカスタム戦略を作成します。
  • モニタリング＆コントロール: 戦略の開始／停止を行い、パフォーマンスをリアルタイムで監視します。
  • 注意：現在は先物取引のみをサポートしています（現物は1X先物として実装）。先物口座に十分な残高があることを確認してください

サポートされている取引所

取引所 備考 ステータス
Binance 国際サイト binance.com のみサポート（米国サイトは非対応）。USDT-M 先物（USDT証拠金契約）を使用します。先物口座に十分な USDT 残高があることを確認してください。取引ペア形式: BTC/USDT。注意：無期限先物口座の残高が0でないことを確認してください。API申請時はIPホワイトリストを追加してください（検索エンジンでMy IPを検索して確認） ✅ テスト済み
Hyperliquid 証拠金通貨として USDC のみサポートします。メインウォレットアドレス + API ウォレット秘密鍵認証を使用します（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を参照してください

ValueCellは包括的なWebインターフェースを備えたPythonベースのアプリケーションで、マルチプラットフォーム展開をサポートしています。以下の設定に従って、すぐに始めることができます。

リポジトリのクローン

git clone https://github.com/ValueCell-ai/valuecell.git
cd valuecell

アプリケーションの実行

完全なアプリケーション(フロントエンド、バックエンド、エージェント)を起動します:

Linux / Macos

bash start.sh

Windows (PowerShell)

.\start.ps1

インターフェースへのアクセス

  • Web UI: ブラウザでhttp://localhost:1420にアクセス
  • ログ: ターミナルで直接アプリケーションログを確認し、バックエンドサービスと個々のエージェントの詳細な実行時情報を取得

次のステップ

アプリケーションが起動したら、WebインターフェースでValueCellの機能を操作して探索できます。

設定

詳細な設定情報については、CONFIGURATION_GUIDEを参照してください

ロードマップ

🤖 強化されたエージェント機能

取引能力

  • 暗号通貨: 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（プロプライエタリ）
取引所 API（Binance、OKX、Hyperliquid など） REST/WebSocket エンドポイント 各取引所の利用規約（例: Binance API 規約）
LLM プロバイダー（OpenAI、Azure、Google、DeepSeek など） 推論 API プロバイダー固有の利用規約（例: OpenAI 利用規約）

Star History