Hunter Community Edition

<div align="right">

**🌏 中文(当前)· [English](./README_EN.md)**

</div>

<div align="center">

<img src="./docs/assets/logo.png" alt="Hunter Community · agentpit.io" width="200" height="200" />

# Hunter Community Edition

### 别人的策略 · 你自己的 SKILL
### 一个平台 · 一亿套系统

*Your investment brain, on your terms*

**开源自部署 · 一 key 通用 · 5 分钟跑起来**
*Your private financial AI team · one API key · self-hosted in 5 minutes*

[![License](https://img.shields.io/badge/license-Apache_2.0-blue)](./LICENSE)
[![CI](https://github.com/agentpit-io/hunter-community/actions/workflows/ci.yml/badge.svg)](https://github.com/agentpit-io/hunter-community/actions/workflows/ci.yml)
[![Docker](https://img.shields.io/badge/ghcr.io-agentpit--io-blue)](https://github.com/agentpit-io/hunter-community/pkgs/container/hunter-community-api)
[![GitHub Stars](https://img.shields.io/github/stars/agentpit-io/hunter-community?style=social)](https://github.com/agentpit-io/hunter-community)

[**🚀 Live Demo**](https://hunter-community.agentpit.io) · [**📖 Docs**](./docs/01-getting-started.md) · [**🐦 Twitter**](https://x.com/agentpit_io) · [**⭐ Star us**](https://github.com/agentpit-io/hunter-community)

<br>



https://github.com/user-attachments/assets/37f4a065-663b-4eee-8d3f-c9c0573270e3

*SaaS 完整演示 · 3 分 34 秒 · 深度分析 + 走势预测 + SKILL 使用 · 点视频左下角播放*

</div>

---

## 📖 目录

- [这是什么](#-这是什么)
- [为什么选 Hunter](#-为什么选-hunter)
- [核心能力](#-核心能力)
- [5 分钟跑起来](#-5-分钟跑起来)
- [两把 key(唯一需要理解的概念)](#-两把-key唯一需要理解的概念)
- [大模型兼容性](#-大模型兼容性)
- [23 个内置 SKILL](#-23-个内置-skill)
- [技术栈](#-技术栈)
- [架构](#-架构)
- [Provider 矩阵](#-provider-矩阵)
- [扩展 Hunter](#-扩展-hunter)
- [Community vs Cloud](#-community-vs-cloud)
- [常见问题](#-常见问题)
- [Contributing](#-contributing)
- [社区与支持](#-社区与支持)
- [Roadmap](#-roadmap)

---

## 🎯 这是什么

**Hunter 是给个人投资者用的金融 AI Agent 平台**。给它 1 把 key + 1 个大模型 · 你就有一个能查行情、拉新闻、跑深度分析、预测走势、盯自选、按 SKILL 方法论工作的 AI 团队 —— **全部在你自己的机器上运行**。

- 🎯 **一 key 通用** · `hunt_tools_xxx` 一把 key 解锁 **32/33 数据源** + **23 个精修 SKILL** + Kronos 走势预测 + TrueSource 情报
- 🧠 **多模型可插拔** · **DeepSeek v4 pro 实测 P0 默认**(<$0.001/次 · 12-70 秒)· 通义/豆包/Claude/GPT env 模板齐全
- 💾 **自部署** · docker compose 一键起 · 数据在你磁盘 · 不上云 · 不联系我们除非你想
- 🔌 **易扩展** · Markdown 写 SKILL 方法论 · GitHub 一键装 SKILL · 接自己的 MCP · 三种扩展全支持
- 💰 **免费开源** · Apache 2.0 · fork 随便用(仅须换名)

Live preview: **[https://hunter-community.agentpit.io](https://hunter-community.agentpit.io)**
(演示站开了多用户 · 首次访问会引导你注册 · 自己 clone 下来跑不需要账号)

---

## 🌟 为什么选 Hunter

| 别人家 | Hunter |
|---|---|
| **OpenBB · FinGPT** — 需要自己拼 provider 与 tool · 上手 2-3 天 | 开箱即用 · 5 分钟跑起来 · SKILL 就是方法论 · 加一个就多一种分析 |
| **TradingView** — 强图表 · 但只订阅 · 不能自部署 · 数据不出户 | 数据在你磁盘 · 想接自己的 broker / 数据源 / MCP 完全放开 |
| **Cursor / Cline 通用 agent** — 通用但金融要自己教 | 23 个金融专精 SKILL · 卖方研究员级方法论 · 覆盖尽调/估值/组合 |
| **通用 ChatGPT** — 能答但拿不到实时数据 · 不会调工具 | 一 key 通吃行情/新闻/K 线/龙虎榜/北向 · Function calling 精准分流 |

---

## ✨ 核心能力

<table>
<tr>
<td width="25%">

**💹 数据(32/33 源)**
- 实时行情 · A/港/美股
- 30 天 K 线 · 财报 · 新闻
- 龙虎榜 · 十大股东 · 治理
- 北向资金 · 南向资金 · AH 溢价
- 巨潮公告 · 行业分类

</td>
<td width="25%">

**🧠 AI 能力**
- 23 个精修 SKILL(下方展开)
- Kronos 走势预测(清华时序模型)
- TrueSource 主动情报采集
- DeepSeek/qwen/Claude/GPT 可插拔
- MCP 工具循环 · 自动分流

</td>
<td width="25%">

**💬 交互**
- SSE 流式对话 · 边想边输出
- 富卡片渲染(报价/新闻/预测)
- **侧栏三层**(数据源/工具箱/SKILL · 见 [截图](./docs/screenshots/02-sidebar-toolbox.png))
- 自选 · 持仓 · 信号追踪
- 顶部深度工具菜单(在线分析/K 线预测/信号看板/事件分析 · 见 [截图](./docs/screenshots/06-top-menu-depth-tools.png))

</td>
<td width="25%">

**🚀 部署**
- docker compose 一键起
- 5 分钟(镜像已 pull 后)
- 6 服务 healthy 自动 orchestrate
- bind mount 快速迭代
- 一 key 通用 · 无外部依赖

</td>
</tr>
</table>

---

## 🚀 5 分钟跑起来

### 前置

- Docker Desktop(Windows/macOS)或 Docker Engine + Compose v2(Linux)
- 磁盘 20 GB(opencode 镜像 ~7.5 GB)· 内存 4 GB
- 能访问 `ghcr.io`(对话引擎从这里拉)
- 大模型 key(DeepSeek 免费送 500 万 tokens · [30 秒申请](https://platform.deepseek.com/api_keys))

### 3 步启动

```bash
# 1. 拉代码
git clone https://github.com/agentpit-io/hunter-community
cd hunter-community
cp .env.example .env

# 2. 改 .env 三处(自动生成 JWT_SECRET · 手填 LLM_API_KEY · 可选填 HUNTER_API_KEY)
#    - Linux/macOS
echo "JWT_SECRET=$(openssl rand -base64 48)" >> .env
#    - Windows PowerShell 版见 docs/01-getting-started.md

# 手改 .env 三处:
# LLM_BASE_URL=https://api.deepseek.com/v1
# LLM_DEFAULT_MODEL=deepseek-v4-pro
# LLM_API_KEY=sk-xxxxx
# LLM_SCHEMA_SANITIZE=1                              # DeepSeek 必开
# HUNTER_API_KEY=hunt_tools_xxxxx                    # 免费 · 30 秒申请 hunter.agentpit.io/dev/api-keys

# 3. 起服务(首次 10 分钟拉镜像 · 之后 30 秒)
docker compose up -d
open http://localhost:3100
```

**首次测试**(打开浏览器后):
- 问"601899 现在多少钱" — 会看到富卡片(实时价 · 52 周分位 · AI 短评)
- 问"预测茅台走势" — Kronos GPU 推理 · 30-70 秒出未来 10 天 K 线预测
- 点侧栏「深度分析」输入代码 — 60-300 秒出 22 维度深度报告

**详细指南**:[`docs/01-getting-started.md`](./docs/01-getting-started.md)

---

## 🔑 两把 key(唯一需要理解的概念)

这是使用本项目**唯一需要理解的概念** · 其余都是照抄命令。

| | 谁的 key | 干什么 | 不填会怎样 |
|---|---|---|---|
| **① 大模型 key** | 你自己的(DeepSeek / OpenAI / OpenRouter / OneAPI) | 驱动对话本身 | 聊天不可用 |
| **② Hunter 平台 key** `hunt_tools_xxx` | 我们签发 · [免费申请 30 秒](ht

... (truncated)