wraeclast-whisperer

# Wraeclast Whisperer ![Python Version](https://img.shields.io/badge/dynamic/toml?url=https%3A%2F%2Fraw.githubusercontent.com%2Fdarecstowell%2Fwraeclast-whisperer%2Frefs%2Fheads%2Fmain%2Fpyproject.toml&query=%24.tool.poetry.dependencies.python&label=Python) ![Chainlit Version](https://img.shields.io/badge/dynamic/toml?url=https%3A%2F%2Fraw.githubusercontent.com%2Fdarecstowell%2Fwraeclast-whisperer%2Frefs%2Fheads%2Fmain%2Fpyproject.toml&query=%24.tool.poetry.dependencies.chainlit&label=Chainlit&color=red) ![Last Deployment](https://img.shields.io/github/actions/workflow/status/darecstowell/wraeclast-whisperer/fly-deploy.yml?branch=main&label=Last%20Deployment)

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.

alt text

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

Installation

Clone the repository
Copy .env.example to .env and add your OpenAI API Key
```
 cp .env.example .env
```
Install and start up Docker
Start the container
```
 docker compose up -d;
```
Wait for container to build, then navigate to http://localhost:8080/ in your browser.
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

This site is open source. Improve this page.