Wraeclast Whisperer

A GPT-powered agent for Path of Exile 2 with up-to-date game data that helps players synergize their builds, assess their gear, search for valuable trades, create loot filters, answer game-related questions, and more.

Description

This GPT-powered agent analyzes PoE2 wiki data, popular PoE2 build webpages, current game data, and real-time player data to offer insights and recommendations. This agent is not intended to create builds for you but to aid you on your journey.

Planned Features

Completed

• General Game Knowledge Assistance
  e.g., "How does Acrobatics work?"

• Build Suggestions
  e.g., "What are the meta builds right now?"

In Progress / Upcoming

• Gear Upgrade Assessment
  Upload a screenshot of an item and ask, "Is this an upgrade for me?"

• Synergies Analysis
  e.g., "What skill gems work well with X?"

• Tailored Loot Filter Generation
  e.g., "Make a basic early-game loot filter for my character that ignores grey items."

• Trade Search
  e.g., "What are some good swords available on the market for my character?"

Data Sources

• Official POE2 Wiki
• Web searches (responsibly -- respects robots.txt and sitemaps)
• PoE 2 Client Logs
• PoE 2 Game Data
• PoE 2 API (not yet available) - Trade data, non-authenticated player data
• YouTube Transcripts

None of the data mentioned above (except for game data) is stored or used for any other purposes. This data is requested by the user and is only accessible during the user's chat interface session.

Prerequisites

• OpenAI API key
• Docker

Installation

1. Clone the repository

2. Copy .env.example to .env and add your OpenAI API Key

   cp .env.example .env

3. Install and start up Docker

4. Start the container

   docker compose up -d;

5. Wait for container to build, then navigate to http://localhost:8080/ in your browser.

6. By default, the login is:

   • Email: admin
   • Password: admin

Devcontainer Instructions

Using Devcontainer in VSCode

• Must have Docker installed.
• Install Extension: https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers
• Use vscode command -- "Dev Containers: Rebuild Container"

Development Notes

This project uses:

• Poetry for dependency management
• Black for code formatting
• Ruff for linting
• MyPy for type checking
• Chainlit as an agent framework with beautiful UI
• Playwright for rendered web scraping
• Fly.io for deployment

License

This is an unofficial Path of Exile 2 app and is not affiliated with or endorsed by Grinding Gear Games.

This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.

You are free to:

• Share — Copy and redistribute the material in any medium or format.
• Adapt — Remix, transform, and build upon the material.

The licensor cannot revoke these freedoms as long as you follow the license terms.

This software is provided solely for personal and non-commercial use. Any use of this software or its derivatives for commercial purposes is strictly prohibited.

See the LICENSE file for details.

Acknowledgments

• Path of Exile 2 and all related content are the property of Grinding Gear Games. This Go Support them!
• Chainlit