AutoHedge · 第 2 章 环境准备与首次运行

AutoHedge · 第 2 章 环境准备与首次运行

章节摘要:本章属「上手篇」,讲清把 AutoHedge 跑起来的全部前置。先是 Python + Poetry 的安装与依赖管理(项目用 Poetry 打包,核心依赖 swarms、openai、httpx、loguru、rich、solders、yfinance);再是 .env 配置全解——需要 OpenAI key、Jupiter key、可选的 Solana 私钥(WALLET_PRIVATE_KEY)等,以及 env_loader.py 如何从当前目录向上递归查找 .env;最后用 example.py 跑通第一个分析任务。本章共 3 节,前置依赖为「第 1 章」。

学习目标

阅读完本章,你应当能够:

1. 用 Poetry 或 pip 安装 AutoHedge 及其依赖。
2. 看懂 .env.example 并配齐所需环境变量(OpenAI 是必须,Solana 私钥按需)。
3. 理解 env_loader.py 的递归 .env 查找逻辑。
4. 用 example.py 跑通第一个市场分析任务。

⚠️ 配置 Solana 私钥(WALLET_PRIVATE_KEY)时务必用测试钱包,切勿填入主资产钱包私钥——任何泄露即资产清零。

核心概念速览

配置是 AutoHedge 的命脉——key、模型、私钥都在 .env 里,理解 .env 就理解了它的运行边界。

子章节导航

01 Python 与 Poetry 安装

Python 3.10+、Poetry、核心依赖清单(swarms/openai/httpx/solders 等)、安装步骤。

02 .env 配置全解

.env.example 逐项解读:OPENAI_API_KEY、JUPITER_API_KEY、WALLET_PRIVATE_KEY、WORKSPACE_DIR 等。

03 example.py 跑通首个任务

example.py 逐行解读、AutoHedge 初始化、run() 的 task 参数、如何看输出。

子章节之间的逻辑关系

本章第 01 节(安装) ──► 第 02 节(.env 配置) ──► 第 03 节(跑起来)
   │
   ▼
下一章(第 3 章 多 Agent 编排核心)
​

前置知识与后续延伸

前置知识:

• 第 1 章(理解架构)
• Python 包管理基础

后续延伸:

• 第 3 章讲跑起来后,Agent 内部怎么协作
• 第 8 章会用到这里配的 Solana 私钥