Skip to content

Bring your own AI, any of 28 providers. Any Foundry system, deepest on D&D 5e (2024).

Your AI co-pilot for Foundry VTT.

You bought Foundry to run the game for everyone else. Familiar takes the dungeon master's side: the rules, the dice, the monsters, every NPC in its own voice. So you finally get to play. Solo, one on one, or a full group.

Two weeks free, then $5 a month.

Install

Install Familiar in Foundry

Familiar is in the official Foundry package directory. Search for it, or paste the manifest URL. Both use the same Install Module dialog and install the current release.

Recommended

Foundry's package browser

  1. In Foundry, open Configuration then Add-on Modules.
  2. Click Install Module.
  3. Search "Familiar", then click Install.
Alternative

Manifest URL

If you would rather paste it in, the manifest URL installs the same release from the same dialog.

  1. Paste the URL into the Manifest URL field at the bottom of the same dialog.
  2. Click Install.
Manifest URL: https://github.com/Ryanjansen92/familiar-releases/releases/latest/download/module.json

Compatibility

Foundry VTT
v13, v14
Game System
D&D 5e (2024 rules): full support, rules engine included. Every other system: everything except refereeing combat, with your characters read as your own system stores them. See what it does on your game system
See the Install Module dialog
Foundry's Install Module dialog, with the package search box at the top and the Manifest URL field at the bottom.

Out in the open. Listed in Foundry's package directory, published on npm and GitHub, questions answered in Discord, and a subscription you close yourself.

Bring your own AI

Connect the AI you already use.

Paste an API key, point Familiar at the Claude, ChatGPT, or Gemini subscription you already pay for, or run a model on your own machine. Every path reaches the same 195 tools; the difference is where the model runs and who you pay.

Built-in chat

Paste an API key and start talking to your game.

No server, no terminal, no config files. Live transcription, auto-pilot for NPC turns, slash commands, and drag-and-drop attachments only work here. A Thinking control lets you set how hard the model reasons, dialled up for hard fights, down for quick lookups.

Chat (16 providers)

  • Anthropic
  • OpenAI
  • Google (Gemini)
  • Groq
  • Mistral
  • Together AI
  • DeepSeek
  • xAI
  • Cohere
  • Perplexity
  • Fireworks AI
  • Cerebras
  • SambaNova
  • NanoGPT
  • Local / custom server

OpenRouter unlocks 300+ models on a single key. Local / custom server points the built-in chat at any OpenAI-compatible server you run, from its own Local AI settings tab.

Voice (5 providers)

  • ElevenLabs
  • Cartesia
  • OpenAI TTS
  • OpenRouter TTS
  • Custom TTS

Image (4 providers)

  • OpenAI (GPT Image)
  • fal.ai
  • Leonardo AI
  • OpenRouter

Transcription (3 providers)

  • Gladia
  • Deepgram
  • AssemblyAI
Familiar's built-in chat settings in Foundry: the AI provider set to OpenRouter (one key, 300+ models), an API key field noting the key is stored locally in your browser and never sent to a Familiar server, plus a model picker, a Thinking control for reasoning effort, and a streaming toggle.

Use your subscription

Already paying for Claude, ChatGPT/Codex, or have a Google account? Put it to work.

Connect through the Model Context Protocol and your existing subscription becomes a DM assistant at no extra API cost. The module ships with an MCP Setup Wizard that detects your client and generates the config to paste in. Best for long, multi-step chains. Your model and its reasoning effort are set in your own client, not here.

MCP clients (6 providers)

Familiar's MCP and subscription setup in Foundry: six client cards in three groups, Claude Desktop and Claude Code under an Anthropic subscription, Codex CLI and Codex Desktop under a ChatGPT subscription, and Antigravity CLI and Antigravity Editor under a free Google account.

Run it local

Your own machine, no per-token bill.

The same built-in chat, pointed at a server you run. Pick a preset, check the URL it fills in, and flip Use for chat on. Your hosted provider stays saved for switching back.

Runners

  • Ollama
  • LM Studio
  • llama.cpp
  • LiteLLM
  • Any OpenAI-compatible server
Familiar's Local AI settings tab in Foundry: the Use for chat switch, a preset dropdown set to LM Studio, the base URL http://localhost:1234/v1, an optional API key field, a model id field, and a streaming toggle.

Your keys, your cost.

Most paid AI modules for Foundry route through their own servers and ration you by the message. Run out mid-session? Too bad. Familiar never proxies or marks up anything: your API keys go straight from your browser to the provider, and with MCP your subscription handles it. No middleman, no per-turn meter.

Combat & AI

The AI plays the monsters; a rules engine decides what is allowed. In a live fight it cannot invent a die roll, write damage into a sheet, drop a condition from nowhere, or move past a creature's speed. The rules it cannot fake live in code, not in its prompt.

  • Every action checked against the 5e rules before it lands
  • A refused move is refused out loud, and the AI adapts
  • Foundry's own dice roll every attack, save, and damage
  • Initiative, turns, rounds: the whole encounter flow
  • Multiattack, legendary actions, reactions, opportunity attacks
  • Undo the last action when a call goes wrong

Roll initiative for all the goblins, have them attack the nearest player, and play battle music.

How the engine enforces the rules

NPC Voices

Give every NPC its own voice. Multi-voice text-to-speech across ElevenLabs, Cartesia, OpenAI, or your own endpoint. Familiar remembers who sounds like whom, so the innkeeper always sounds like the innkeeper.

  • Give each NPC its own voice
  • Speak any line aloud in a character's voice
  • Voice a whole scene, a different voice per speaker
  • Lock a fixed voice to any character
  • Multi-voice text-to-speech: ElevenLabs, Cartesia, OpenAI TTS, and more

Dim the lights, start rain and thunder, and have the innkeeper whisper a warning about the road ahead, in his voice.

Giving your NPCs a voice

Scenes, Canvas & Art

Build the whole scene by asking: tokens, walls and doors, lighting, weather, fog of war, trigger regions. Then generate the art to fill it, from a battle-map background to a portrait of the stranger who just walked in. Familiar places it, you direct it.

  • Create scenes and spawn tokens from any compendium
  • Draw walls, doors, and trigger regions
  • Set lighting, darkness, and weather effects
  • Fog of war, ambient sound, and camera control
  • Generate a battle-map background from a text prompt
  • Generate character portraits and item art inline

Generate a foggy graveyard battle map, give me three options, and use the second one as the background.

Audio & Atmosphere

Play, stop, and manage playlists and individual tracks with volume and fade control. Cue battle music, build ambient soundscapes, or silence everything without touching Foundry's sidebar.

  • Play, stop, and queue playlists
  • Individual track control with volume and fade
  • Crossfade between tracks
  • Cue battle music on combat start
  • Build ambient soundscapes
  • Silence everything without touching the sidebar

Cue the tavern playlist, drop the lights, and let the bard play a soft lute track underneath.

Knowledge & Memory

Semantic search across all journals, characters, scenes, and items. A persistent memory bank stores important campaign facts that carry over between sessions, with full journal management for session notes and handouts.

  • Semantic search across journals, characters, scenes, items
  • Persistent memory bank across sessions
  • Summarise sessions when you say you're done
  • Full journal and handout management
  • Map pin creation and editing
  • Send and read chat messages from any source

We're done for tonight. Summarise what happened this session and save it.

Characters & Items

Inspect, create, update, and clone actors, inventory, spells, features, and active effects. Import from compendiums, apply custom buffs, and manage player ownership.

  • Inspect, create, update, and clone actors
  • Manage inventory, spells, and features
  • Apply and toggle active effects (buffs and debuffs)
  • Import from any compendium pack
  • Configure player ownership and permissions
  • Roll on tables for random encounters and loot

Find a CR 3 werewolf in the compendium, drop it into the scene as a boss, and give it resistance to non-silvered weapons.

Auto-Pilot

Click "Run NPC" and walk away. On D&D 5e (2024) Familiar plays every enemy turn for you, with safety caps and optional turn-by-turn confirmation.

  • One click runs every NPC turn in the encounter
  • Safety caps prevent runaway loops
  • Turn-by-turn confirmation when you want it
  • Works alongside the standard combat tracker
  • Battlefield snapshots inform tactical decisions
  • Stops on the round or the turn you name

Run all the NPC turns this round. Stop after the dragon goes.

Familiar's transcription settings: session transcription and dictation enabled, a hands-free send mode with a short pause before sending, and the Gladia provider with the API key stored in the browser.

Live Transcription

Speak instead of type. Familiar transcribes your session in real time across three providers, colour-codes per speaker, and saves the transcript to a Foundry journal entry you can edit and search later.

  • Speak instead of type in the middle of a scene
  • Real-time transcription across three providers
  • Per-speaker colour coding
  • Saves directly to a Foundry journal entry
  • Edit and search the transcript afterwards
  • Gladia, Deepgram, AssemblyAI

Start transcribing the session. Save it to a journal called 'Session 12' when we're done.

Multi-Session Chat

Pin, archive, and switch between named campaign threads. Each thread persists as a Foundry journal entry with a full audit log, so you can return to any conversation later, even months apart.

  • Pin, archive, and rename campaign threads
  • Each thread persists as a Foundry journal entry
  • Full audit log of every tool call
  • Switch between threads without losing context
  • Search across past conversations
  • Re-open a paused side quest in seconds

Open the 'Stormpoint Castle' thread and pick up where we left off last week.

Works together

Built around the content you already have.

Familiar doesn't replace your modules, maps, or campaigns. It reads them, runs them, and stays out of your way.

  • Premade campaigns

    Open Ember, Dragon of Icespire Peak, or any published adventure. Familiar reads the journal entries, NPCs, and encounters that came with it, and runs them at the table without inventing contradictions.

  • Battle maps you already use

    Drop a Czepeku or Patreon map. Familiar fetches the tokens, lights, walls, and ambient sound you set up, and runs combat on top of someone else's craft.

  • Compendia and your own homebrew

    Your custom NPCs, your house rules, your D&D Beyond imports. Familiar reads what's already in your world instead of making things up.

Familiar doesn't ship its own adventures, maps, or compendia. The content is yours, whatever system your campaign was written for. Your AI tells the story you bring, it doesn't invent one, and Familiar runs the dungeon master's side of the table on top of it.

Plays at any table

Play solo, duet, or with a full group.

However many show up, you get to play. The fewer humans at the table, the more of the world Familiar runs, the dice, the monsters, every NPC, and on D&D 5e the rules. You take a seat at the game you usually run for everyone else.

  • Solo

    Just you

    You play your character. Familiar runs everything around it: every NPC in its own voice, every monster's turn, the scene, with 2024 D&D 5e rules enforced. Campaign memory carries the world from one session to the next.

  • Duet

    You and one other

    Neither of you has to be the DM. Familiar runs a D&D 5e (2024) world for both of you, the cast, the encounters, the rulings, so you stay players and the story still moves.

  • Small table

    You and a few

    The supporting cast and the monsters' turns run for you, with the lighting, the music, and the rulings, so nobody steps out of the game to keep it moving.

  • Full group

    You DM for four or more

    The tactical load comes off the GM. You run the encounter and tell the story; on D&D 5e (2024) Familiar handles initiative, the monster turns, and the bookkeeping. You run the scene, not the spreadsheet.

It runs the DM's side around you; it never invents the story. Whoever is at the table, the campaign you brought is the spine, and the dice and the maths are always right on D&D 5e (2024). No "you rolled a 47."

How it works

One message in. Familiar runs the Foundry actions out.

No new app to learn, and no commands to memorise. Familiar works from its own chat inside Foundry, or from an MCP client you already use.

  1. You talk

    Type in Familiar's chat inside Foundry, or connect an MCP client like Claude, Codex, or Antigravity. Your AI reads the scene and picks which of the 195 tools to call.

  2. Over a secure socket

    Tool calls reach your world over an authenticated WebSocket. Your API key goes straight from your browser to your provider. Familiar never proxies or stores it.

  3. Familiar runs it

    The module runs the same Foundry operations you would do by hand: place tokens, set lights, cue music, pull a creature from your compendium. You stay in character.

Built-in chat needs nothing extra. MCP adds a small local server you start with one command.

Why I built this

A co-pilot for the game master who'd rather run the story than the spreadsheet.

I'm Ryan. Dad of two young kids, married to my favourite person, with the free time you'd expect.

My wife and I play D&D together, just the two of us, 1-on-1 campaigns. It's our thing. But solo DMing is a lot. You're the storyteller, every NPC, the rules engine, the sound guy, and the atmosphere all at once. Mid-monologue as a mysterious stranger, I'd have to break character to roll initiative, look up a spell range, adjust the lighting, and find that one tavern ambience track I swore I bookmarked. By the time I got back to the scene, the moment was gone.

I wanted something that could handle the mechanical side of the table so I could stay in the story. Not a replacement DM, a co-pilot. Something I could say "roll initiative for the goblins, dim the torches, and start combat music" to, and it would handle it. While I kept talking.

So I started building. First it was a handful of tools to move tokens and roll dice. Then I added combat tracking. Then scene management. Then "what if it could also generate NPC portraits on the fly?" and "what if it could voice the tavern keeper?" That's how you end up with 195 tools across 24 domains and 28 AI providers.

I took my time with this. I ran Familiar at my own table, session after session, before opening it up. I didn't want to ship another AI that turns your campaign into nonsense the moment it forgets last week.

It started as a personal itch-scratcher for a dad who wanted to run better D&D games for his wife. It turns out a lot of GMs have the same itch.

Ryan, working on Familiar

Pricing

Two weeks free. Your keys, your cost.

$5 a month or $45 a year keeps Familiar maintained. Your AI provider bills you directly for the tokens you spend. No markup, no middleman, no per-turn limits.

Feed the Familiar$5per month
Run it for a year$45per yearsave 3 months

Free for 14 days, then $5.

Billed monthly or yearly. Cancel anytime.

Already subscribed? Manage or cancel it here
  • All 195 tools, with the rules engine on D&D 5e (2024)
  • Every update. Combat AI, voice, image, transcription, memory
  • BYOK or MCP. Connect any provider on the list
  • Bug reports and feature ideas welcome on Discord

What you pay your AI provider

Familiar never proxies or marks up tokens. Anthropic, OpenAI, OpenRouter, your MCP subscription: you set up the key, they bill you. A typical D&D session runs $0.50 to $3 in API costs, depending on the model. Or nothing: a subscription through MCP, or a model you run on your own machine, costs you no tokens.

Common questions

Honest answers.

The questions players and GMs actually ask, answered straight. Anything else, ask in the Discord.

  • What is Familiar?

    Familiar is an AI co-pilot for Foundry VTT, the virtual tabletop you run your D&D game in. You connect the AI you already use, such as Claude or ChatGPT, over the Model Context Protocol or an API key, and it runs the dungeon-master side of a published D&D 5e adventure you import: the rules, the dice, the monsters, and the NPC voices. You stay the player and keep the story; Familiar handles the table.

  • Is there an AI DM module for Foundry VTT?

    Yes. Familiar is an AI DM module for Foundry VTT: connect the AI you already use and take a seat as a player, while it runs the whole DM side of a published D&D 5e adventure you import, combat, dice, and NPC voices included. Bring Claude, ChatGPT, or Gemini over MCP, or any of 28 providers by API key. You install it from the Foundry package browser or a manifest URL, and the first 14 days are free.

    Read the setup guide
  • Does the AI actually follow the D&D rules in combat?

    The rules it could cheat on, it cannot: dealing damage, dropping a condition, moving past a creature's speed, and faking a die roll all live in code the model does not control, and Foundry's own dice roll every result. The judgement calls, a flanking house rule or a narrative exception, stay yours, and any override the AI makes is written to the chat log. Where a rule is not modelled yet, Familiar flags it and leaves the ruling to you.

    Read the combat guide
  • How do I connect Claude or ChatGPT to Foundry VTT?

    Two ways, and you bring your own AI for both. Use the Claude, ChatGPT, or Gemini subscription you already pay for over the Model Context Protocol, and Familiar runs as an MCP server those clients connect to. Or paste an API key into the built-in chat. The same tools work either way; the difference is where the model runs and who you pay.

    Read the connect guide
  • Does Familiar work on The Forge or other hosted Foundry?

    Yes, both paths. The built-in chat runs anywhere Foundry does, because the module calls your AI provider straight from the browser. The MCP link works too: the local server runs on your own computer, and your browser connects to it directly, so your hosting provider is never in the path. Run the setup wizard from your hosted game and the config it generates already carries the one extra setting for this, your game's URL in FAMILIAR_WS_ALLOWED_ORIGINS. There's nothing to hand-edit.

  • Does Familiar collect my data?

    No telemetry, no analytics, no calls home. Familiar runs inside your Foundry world; data only leaves when you message your chosen AI provider. Point the Local AI tab at a model on your own machine and even that stops, because the built-in chat talks to your server instead.

    Read the local models guide
  • Can the AI break my world?

    Document updates are sanitised, so the AI can't change ownership, permissions, or internal IDs. Destructive operations require confirmation, and the WebSocket connection is authenticated with a shared secret. Keep backups anyway: good practice with or without AI.

  • Does it work with game systems other than D&D 5e?

    Yes, with one boundary: the rules engine that referees combat is D&D 5e (2024) only. Everywhere else Familiar names your game system in its first reply and reads your world's own compendium instead of quoting D&D at you. The story, the NPCs, the scenes, the audio, and the campaign memory run there too.

    See what runs on your system
  • Which AI models work best?

    Any current flagship from Anthropic, OpenAI, or Google handles tool-use best; see the "Choosing an AI model" guide for the named tiers. Bring whichever key or subscription you already pay for. Reasoning headroom is what carries a hard combat or a tangled scene: the built-in chat has a Thinking control you can turn up when a moment earns it, and over MCP that dial lives in your own client.

  • Can an AI help me run D&D solo?

    Yes, that's a main reason it exists. Most people who own Foundry are the GM, the one who never gets to play. Familiar runs the rules, the monsters, and the NPCs, and remembers your campaign across sessions, so you can take a seat at your own table, solo or one on one. It's how Familiar started: 1-on-1 D&D with my wife.

  • Do I need my own campaign to start?

    No. Buy a Foundry-ready adventure (official D&D modules run about $20 to $30, with the maps and lighting already built), drop in a battle map or two, enable Familiar, and you're playing. Familiar reads the adventure's journals so it knows the story you're about to discover, and pulls monsters and items from your compendia as you go.

  • Does the AI play a character on my side?

    Yes. Familiar runs the DM's side (the rules, the monsters, every NPC), and it takes an ally's turn beside you too: a friendly NPC runs on auto-pilot like any monster, and you can hand it a full party character to play. In my own weekly campaign, Familiar has played two of the three heroes for months.

  • Does the AI remember my campaign between sessions?

    Yes, in three layers. Your chat threads save as Foundry journals and reopen where you left them. In the built-in chat a bank of campaign facts is injected into every conversation, so what was true last week is still true tonight. A running plot summary carries the story itself. Open the journal called "[Familiar] Campaign Memory" in Foundry to read everything it has stored, and edit or delete anything that came out wrong.

    Read the memory guide
  • How do I cancel my subscription?

    In the customer portal at familiarvtt.com/account. Polar handles the billing as merchant of record, so cancelling happens there: sign in with the email address you paid with, and the same portal switches you between monthly and yearly, updates your card, and hands you your invoices. Cancelling takes effect at the end of the period you already paid for. If the portal does not recognise your email, ask in the Discord.

    Open your subscription page
  • Can an AI run my game as the Dungeon Master?

    Yes, with one honest qualifier. AIs are poor at inventing a story, so Familiar doesn't ask them to. You bring a published adventure with its maps and NPCs, your AI reads it and runs it, and a human can take over anytime. Connect your own AI and it runs the whole DM side with a memory of your campaign across sessions.

Roadmap

Things I'm working toward.

No promises on timelines. Roughly in priority order.

Better solo and duet play.

For the GM who runs the table for everyone else and wants to play for once. Familiar already runs the DM's side; these sharpen it for a table of one or two.

  • Companion mode: point at an ally once and let the AI run its turns hands-free
  • Encounter scaling: balance a fight for a solo or duet party
  • Solo mode: a one-click preset for the rules, the monsters, and the NPC voices

Talk to the modules you already use.

Let Familiar drive the rest of your Foundry stack: animations, loot, effects.

  • Sequencer + JB2A: orchestrate spell animations
  • Token Magic FX: shader effects on tokens and tiles
  • Item Piles: loot drops and merchants
  • DFreds Convenient Effects: status effects and buffs

Deeper reads for the system you play.

Story, NPCs, scenes, audio, and memory already run on any Foundry system, and characters read through a generic adapter. Planned here is the native read: your system's own sheet fields, named the way your system names them.

  • D&D 5e (2024), full sheet and rules engineShipped
  • Any other system, generic sheet readShipped
  • Pathfinder 2e, native sheetPlanned
  • Call of Cthulhu, native sheetPlanned
  • Savage Worlds, native sheetPlanned

Plug-and-play campaigns.

Import a published adventure and Familiar already knows the story, NPCs, maps, and encounters. Starting with Ember.

Ember is Foundry's official 500-hour sandbox campaign. More published adventures to follow.

Sharpening what already ships.

  • Combat AI: retreat, morale, group coordination
  • Voice: emotion control, more natural multi-voice scenes
  • Image: consistent character portraits across sessions
  • MCP: richer real-time tool-progress feedback for external clients

Got an idea? The Discord is the best place to push something up the list.

Ready to play for once?

Install Familiar in Foundry and your first two weeks are on the house. Cancel anytime, your world stays yours.

I'm Ryan, I built Familiar. Join the Discord and I'll personally help you get going.