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

Crate	Description
`tool-calling`	Shared LLM client and tool definitions
`chat-agent`	Simple single-turn agent for the web app
`build-agent`	Complex multi-step build generator (has its own docs and backlog)
`pob-headless`	Path of Building 2 Lua engine wrapper
`wiki`	PoE2 wiki data fetcher with caching
`knowledge`	Pre-summarized game concepts for LLM context

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

poe2-agent 0.3.2