HeroLab AI Assistant

Select characters to begin

HeroLab AI Assistant

Ask anything about the rules, adventure, or your party. Select characters from the sidebar to include their data in the context.

Party summary Best skills Combat tactics Party weaknesses

Hero Lab PC Management

Campaigns
Loading…
Select a campaign to view characters

Add / Remove Characters

Loading…

Character Sheet

📜 Adventure Content

📖 Documentation

  • ▶ Getting Started
    Open the app at your provided URL. It works on desktop and mobile browsers.
    Your party's characters are loaded automatically from HeroLab Online. The AI uses their current stats, feats, spells, and conditions when answering questions.
    Type any question in the chat box and press Send or Enter. The AI responds using PF2e Remastered rules.
  • ▶ Sidebar — Party Members
    • ▶ Character List
      All active characters are highlighted and included in the AI's context. The AI knows their stats, abilities, and current state.
      Active/Inactive toggle (✕ / ✓) — Mark characters inactive to exclude them from the AI context. Useful when a player is absent or for side quests with a partial party.
    • ▶ Character Actions
      ↻ Refresh — Re-fetches a single character's data from HeroLab Online.
      📋 Character Sheet — Opens the character sheet modal with two views: Mini (compact summary) and Full Sheet (detailed view with AoN-linked feats, spells, skills, and items).
      🗑 Remove — Removes a character from the party (requires admin password).
    • ▶ Update All
      Pulls fresh data from HeroLab Online for every active character. Use this mid-combat to ensure the AI knows current HP, conditions, spell slots, etc.
      Example: A character goes unconscious during an encounter. Hit Update All, and the AI will know that character is down when you ask tactical questions.
    Toggle Sidebar — Show or hide the sidebar via the ☰ menu. On mobile, the sidebar slides in as an overlay.
  • ▶ Chat Interface
    • ▶ Asking Questions
      Type any question about your characters, PF2e rules, tactics, or adventure content. Press Enter to send (or Shift+Enter for a new line).
      You can also drag & drop text files into the input box to include their contents in your message.
      The ✕ button clears the chat history and starts a fresh conversation.
    • ▶ AI Responses
      Action symbols — The AI shows PF2e action costs: ◆ (1 action), ◆◆ (2 actions), ◆◆◆ (3 actions), ◇ (free action), ↺ (reaction).
      AoN links — Rules terms, feats, spells, and conditions link directly to the correct Archives of Nethys page.
      Remaster Changes — Rules answers include a section noting differences from Legacy (pre-Remaster) rules, helpful when using older adventure material.
      Legacy redirection — If you ask about a pre-Remaster term (e.g., "Flat-Footed"), the AI redirects to the Remastered equivalent (Off-Guard).
      Reasoning — Some responses include a collapsible "Reasoning" block showing the AI's thought process.
    • ▶ Situational Context
      The AI only knows what HeroLab and you tell it. Situational details not on the character sheet should be typed into your message.
      Example: "Bruce's character is forced to sing by the queen, so he can't provide bard buffs this round. What are our best options?"
    Model selector — Choose which AI model to use from the dropdown in the header. Different models have different capabilities and speed.
  • ▶ ☰ Menu Options
    • ▶ ⚔ PC Management
      Manage campaigns and their associated player characters.
      Campaigns — Add campaigns with a name and HeroLab Online campaign token. Select a campaign to see its PCs.
      Download PCs — Select characters from the campaign list and download their data from HeroLab Online to make them available in the party.
      Add PC to Campaign — Manually associate a PC token with a campaign.
      Remove — Removing campaigns or characters requires the admin password.
    • ▶ 📜 Adventure Content
      Password protected — Enter the admin password to unlock. Your browser remembers the unlock state. Use the Lock button to log out.
      Upload files — Upload .txt or .pdf files. PDFs are automatically converted to text and optimized to reduce token usage.
      Categories — Assign each file a category before uploading:
        ⚔ Adventure — main adventure text
        🐉 Stat Blocks — creature and NPC stat blocks
        📚 Supplemental — maps, handouts, reference material
      File actions (hover to reveal):
        ✏ Rename — edit the file name inline
        🏷 Change category — cycle through categories
        ⬇ Download — download the text file
        🗑 Delete — remove the file (requires admin password)
      Compact — Re-optimizes all text files to reduce token usage (collapses whitespace, removes page numbers and repeated headers).
      Checkboxes — Toggle individual files on/off to control which are included in the AI context.
    • ▶ 📜 Quick Toggle (header button)
      The 📜 button in the header bar quickly enables/disables all adventure content without opening the modal.
      Highlighted = adventure content is active and being sent to the AI.
      Dimmed = adventure content is disabled.
      This setting persists across page reloads.
    • ▶ ⚙ Settings
      User Name & HLO Token — Update your HeroLab Online refresh token. This is the authentication token used for all HLO API requests (fetching characters, campaigns, etc.).
      The current token is shown as a masked preview. Enter both a name and the full token, then click Save.
  • ▶ Tips & Examples
    Character questions:
    "What does my Sudden Charge feat do?"
    "How many spell slots do I have at 2nd level?"
    "Summarize my character's abilities"
    Rules questions:
    "How does flanking work?"
    "What happens when I'm grabbed?"
    "Can I Raise a Shield and Strike in the same turn?"
    Tactical advice:
    "What are our best options against a flying enemy?"
    "Who should attempt Recall Knowledge on undead?"
    "What healing options does our party have?"
    Adventure context:
    "What do we know about the tower from the adventure?"
    "How is the party likely to do in this encounter?"

Context Window Full

The conversation has exceeded the model's context limit. You can compact the chat (summarise the history to free up space) or dismiss this and try a different model.

⚙ Settings

This is the refresh token from your HeroLab Online account. Used to authenticate API requests.
When enabled, automatically falls back to a smaller model if the selected model's context window is exceeded.
Set a custom token limit for the context window. Defaults to the selected model's maximum. Lower this to test compaction or limit context usage.

About

HeroLab AI Assistant

AI-powered assistant for Pathfinder 2e Remastered

Pulls live character data from HeroLab Online and links directly to Archives of Nethys for rules. Responses include clickable AoN links for quick reference. Adventure content like PDFs can be loaded for the AI to reference.

Live Character Data
Characters load automatically from HeroLab Online. Hit "Update All" to pull fresh data mid-combat so the AI always reflects current HP, conditions, and spell slots.
Party Awareness
Toggle characters active/inactive so the AI only considers who's relevant. Partial party for a side quest? Mark the others inactive.
Rules with AoN Links
Ask any rules question and get answers with clickable Archives of Nethys links built in — action costs, traits, success/failure effects, all linked directly to AoN pages.
Situational Context
The AI knows what HeroLab and you tell it. Type in situational details not on the character sheet and the AI factors them into its analysis.
AI Backend
GitHub Models
Built With
FastAPI, HeroLab Online API, Archives of Nethys, Claude Code
Dr. Douglas R. Bowie
"Be Bold. Be Brave. Be Courageous."
— Captain Christopher Pike, USS Discovery