agentpit-io/hunter-community

HunterCodeとは？

HunterCodeは、株式市場調査のためのセルフホスト型AIアシスタントです。自分のコンピューターやサーバーで実行し、大規模言語モデル（LLM）のAPIキーを提供すると、ライブ市場データの取得、ニュースの取得、個別株の分析、価格トレンドの予測、ウォッチリストと保有株の管理ができます。すべての会話とデータは、自分のマシンのローカルデータベースに保存されます。第三者サービスに送信されることはありません。

これは、データを管理し、独自のデータソースや分析方法をプラグインしたい個人投資家、プライベートファンドの研究者、小規模なクオンツチームを対象としています。

実際に何をするのか？

取引ボットではなく、調査アシスタントと考えてください。証券会社には接続せず、取引も行わず、予測を保証するものでもありません。代わりに、公開データ、分析方法論、LLMを一貫した調査ワークフローに整理します。

主な機能：

• 市場データ：リアルタイムの株価、ローソク足チャート、財務レポート、ニュース、主要株主、A株（中国）、香港、米国株式の北向き/南向き資金フロー。
• AI分析：多次元の調査レポート（ファンダメンタルズ、テクニカル、資金フロー）を生成する「ディープ分析」エージェント、9つの異なる投資学派が株式に投票する「投資家パネル」、市場全体の株式スクリーナー、価格予測モジュール（Kronos、清華大学の時系列モデルに基づく）。
• 会話：株価、ニュース、予測を示すリッチカードでチャット。
• SKILLシステム：分析方法論をMarkdownファイル（Anthropic Agent Skills標準形式を使用）として記述し、GitHubからワンクリックでスキルをインストールできます。6つのスキルが内蔵されており、ポンプ・アンド・ダンプのシグナルをスキャンする詐欺検出スキルが含まれます。
• ペーパートレード：完全な注文ライフサイクル（クォートスナップショット→リスクチェック→マッチング→記帳→レポート）を実行する模擬取引台帳で、実際のお金には触れません。意図的に分離されています。コードは実際の取引パラメータを拒否し、データベースロールは文字通り台帳エントリの変更や削除の権限がありません。
• 拡張性：独自のMCP（Model Context Protocol）ツール、OpenAI互換のLLMゲートウェイ、または独自のデータソースを接続できます。

内部ではどのように動作するのか？

HunterCodeはマルチサービスのDocker Composeアプリケーションです：

• Webフロントエンド（Next.js 15）—ブラウザインターフェース
• APIバックエンド（FastAPI）—認証、データアクセス、モデル呼び出し、スキルロード
• 会話エンジン（カスタマイズされたOpenCode）—LLMツール呼び出しループを処理
• Postgres + Redis—ストレージとキャッシュ
• llm-shim—ツールスキーマをクリーンアップし、一部の推論モデルが応答に漏らす「思考」テキストを除去する小さなプロキシ
• Temporal—ペーパートレードスケジュールを駆動するワークフローエンジン（オプションのfinプロファイルを有効にした場合のみ）

独自のLLMキー（DeepSeek、Claude、Qwen、Geminiなど）を持ち込むか、HunterCodeの内蔵クォータ（毎日のトークン割り当て付きの無料キー）を使用できます。データは、無料のオープンソースソース（AKShare、yfinance）、独自のMCPサーバー、またはプロジェクトのプラットフォームデータパイプラインから取得できます。

注目すべき設計詳細

• セットアップウィザード：初回起動時に、5ステップのウィザードが6つのサービスすべてが正常であることを確認し、モデルを選択させ、接続とツール呼び出しをライブでテストし（失敗する設定は保存できません）、データソースを設定します。
• セキュリティ：インスタンスがパブリックインターネットに公開されている場合、セットアップトークンを設定して、ランダムな訪問者がLLMを設定できないようにできます。argon2idパスワードハッシュを使用したJWT認証。
• 監査証跡：完全な監査ログ（AUDIT.jsonl）がアクティビティを記録します。
• 自己進化（オプション）：「パーソナルデプロイメント」モードでは、システムが取引後のレビューから学習し、戦略変更を提案できますが、変更はシャドウ検証を経て、人間の確認後にのみ有効になります。実際の取引はハード無効化されています。

結論

HunterCodeは、実質的で真に機能するオープンソースプロジェクトです。金融調査のためのセルフホスト型AIエージェントシステムで、実際のLLMツール呼び出し、MCP統合、スキルシステム、予測、慎重に分離されたペーパートレードシミュレーションを備えています。ラッパーデモやリンク集ではなく、実際のエンジニアリングを備えたデプロイ可能な製品です。