PoE2 Agent

Open-source AI agents for Path of Exile 2 build analysis and generation.

Overview

This repo provides two agents that share a common tool-calling layer:

• chat-agent — Answer questions about a PoB build using LLM + tool calling (current focus)
• build-agent — Full agentic build generator with multi-step reasoning (future)

Both are library crates, designed to be called from the web server in poe2-app.

Architecture

poe2-app (server)
  └─ chat-agent
       └─ tool-calling (LLM client + tool definitions)
            ├─ pob-headless (PoB Lua engine)
            ├─ wiki (poewiki.net data)
            └─ knowledge (game mechanics for LLM context)

Crates

Building

cargo build --release

Usage

# Set your OpenAI API key
export OPENAI_API_KEY="sk-..."

# Clone PoB2 (if not already present)
git clone https://github.com/PathOfBuildingCommunity/PathOfBuilding-PoE2.git vendor/PathOfBuilding-PoE2

# Run the build agent CLI
poe2-build-agent "cold DoT occultist for endgame bossing"

Development

See CLAUDE.md for project conventions.

The build-agent has its own design docs and ticket backlog in crates/build-agent/.

License

TBD