AutoHedge 部署教程：构建你的自主 AI 对冲基金

AutoHedge 是一个基于 AI 代理和“群体智能”的自动化交易系统，旨在帮助用户构建自主运行的对冲基金。它通过多个专业化的 AI 代理（如策略总监、量化分析师、风险经理、执行员）协作完成从市场分析、策略生成到交易执行的全流程。本教程将指导你完成 AutoHedge 的安装、配置和基本使用。

核心概念与架构

理解 AutoHedge 的设计有助于你更好地使用和扩展它：

多代理架构：系统由四个核心 AI 代理协作组成，形成一个完整的决策-执行链条：
1. 总监代理 (Director Agent)：负责生成和验证交易策略与投资论点。
2. 量化代理 (Quant Agent)：执行技术和统计分析。
3. 风险管理代理 (Risk Management Agent)：评估风险并计算头寸规模。
4. 执行代理 (Execution Agent)：生成并发送交易订单。
风险优先设计：系统在执行任何交易前，都会先经过风险管理代理的评估，确保符合预设的风险参数。
结构化输出：所有分析和建议都以结构化的 JSON 格式 输出，便于记录、审计和集成到其他系统。
当前支持：目前支持在 Solana 区块链 上进行全自动交易，未来计划支持 Coinbase 等交易所。

准备工作：硬件与软件要求

操作系统：macOS、Linux 或 Windows (建议使用 WSL2)。
Python 环境：需要 Python 3.10 或更高版本。推荐使用 venv 或 conda 创建独立的虚拟环境。
网络：需要能够访问互联网，以连接 Solana 网络、获取市场数据并调用 AI API。

第一步：安装 AutoHedge

AutoHedge 已经发布到 PyPI，可以直接使用 pip 进行安装，这是最推荐的方式。

1 2	# 在激活的虚拟环境中执行 pip install -U autohedge

-U 参数确保安装的是最新版本。

第二步：配置环境变量

AutoHedge 通过环境变量来管理 API 密钥和敏感信息。你需要创建一个 .env 文件（参考项目中的 .env.example）或直接在 shell 中导出这些变量。

获取必要的 API 密钥：
- JUPITER_API_KEY：用于获取 Solana 代币价格和搜索工具。你可以在 Jupiter Portal 免费申请。
- OPENAI_API_KEY 或 ANTHROPIC_API_KEY：为 AI 代理提供推理能力。至少需要配置一个。
- WALLET_PRIVATE_KEY：你的 Solana 钱包私钥，用于执行交易。请务必妥善保管，切勿提交到代码仓库。

设置环境变量：
你可以创建一个 .env 文件在项目根目录：

# .env 文件示例
JUPITER_API_KEY="你的Jupiter API密钥"
OPENAI_API_KEY="你的OpenAI API密钥"
WALLET_PRIVATE_KEY="你的Solana钱包私钥"
WORKSPACE_DIR="agent_workspace"  # 可选，工作目录

或者，在启动 AutoHedge 前，直接在终端中导出：

1
2
3

export JUPITER_API_KEY="你的Jupiter API密钥"
export OPENAI_API_KEY="你的OpenAI API密钥"
export WALLET_PRIVATE_KEY="你的Solana钱包私钥"

第三步：运行 AutoHedge

完成配置后，你可以通过命令行启动 AutoHedge。

1 2	# 在终端中执行 autohedge

系统启动后，代理们将开始工作：分析市场、生成策略、评估风险，并在满足条件时生成交易信号。所有输出和日志会显示在终端中。

第四步：与 Python 代码集成 (可选)

除了命令行，你也可以在 Python 脚本中调用 AutoHedge 的功能。

# example.py
from autohedge import AutoHedge

# 初始化 AutoHedge (确保环境变量已设置)
hedge = AutoHedge()

# 运行一次完整的分析-决策-执行循环
hedge.run()

故障排查与常见问题

autohedge 命令未找到：
- 确保 AutoHedge 已成功安装 (pip show autohedge)。
- 检查你的 Python 虚拟环境是否已激活，以及其 bin 目录是否在系统的 PATH 中。
API 密钥错误：
- 系统启动时如果报错提示 API 密钥无效，请重新检查 .env 文件或环境变量中的密钥是否正确，并确认相关 API 服务已开通且账户余额充足。
Solana 网络连接问题：
- 确保你的网络环境可以访问 Solana RPC 节点。如果网络受限，可能需要配置代理。
交易执行失败：
- 检查钱包私钥是否正确，钱包中是否有足够的 SOL 代币以支付交易手续费 (gas fee)。
- 检查 Jupiter API 是否可用，以及交易对是否有足够的流动性。
风险控制：AutoHedge 会执行真实交易。在首次使用或测试时，强烈建议使用一个没有实际资产或资产极少的测试钱包，并将风险参数调至最低，以观察系统行为。