Skip to content
Familiar
DiscordInstall in Foundry

191 tools. 25 AI providers. Zero prep.

Your AI co-pilot for Foundry VTT.

You bought Foundry to run the game for everyone else. Familiar takes the DM's side, the rules, the dice, the monsters, and every NPC, so you finally get to play. Solo, one on one, or a full group.

Install in FoundryJoin the Discord
  1. Combat tracker showing initiative order and an active token

Install

Install Familiar in Foundry

Familiar ships directly from GitHub. Paste this URL into Foundry's Install Module dialog.

Manifest URL: https://github.com/Ryanjansen92/familiar-releases/releases/latest/download/module.json
  1. In Foundry, open Configuration → Add-on Modules
  2. Click Install Module
  3. Paste the URL in the Manifest URL field at the bottom, then Install.
Show the Install Module dialog
Foundry's Install Module dialog with Familiar's manifest URL pre-filled in the Manifest URL field at the bottom.
Foundry VTT
v13, v14
Game System
D&D 5e (2024 rules), full support. Other systems work for general features (chat, journals, scenes, audio) but lack system-specific tools like character sheets and combat automation.

Bring your own AI

Connect the AI you already use.

Two ways in. Both give Familiar the same 191 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. Pick a provider, drop in a key, and Familiar handles the rest. Only path with voice, image generation, and transcription on top of chat. Also the only one that runs fully offline through Ollama or LM Studio.

Chat (16 providers)

  • OpenRouter
  • Anthropic
  • OpenAI
  • Google
  • Groq
  • Mistral
  • Together AI
  • DeepSeek
  • xAI
  • Cohere
  • Perplexity
  • Fireworks AI
  • Cerebras
  • SambaNova
  • Ollama (local)
  • LM Studio (local)

OpenRouter unlocks 300+ models on a single key.

Voice (3 providers)

  • ElevenLabs
  • Cartesia
  • OpenAI TTS

Image (3 providers)

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

Transcription (3 providers)

  • Gladia
  • Deepgram
  • AssemblyAI

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. Copy and paste. Best for long, multi-step tasks.

MCP clients (8 providers)

  • Claude Desktop
  • Claude Code
  • Codex CLI
  • Codex Desktop
  • ChatGPT
  • Antigravity CLI
  • Antigravity Editor
  • Gemini CLIdeprecated 2026-06-18

Google is sunsetting Gemini CLI on 2026-06-18. Migrate to Antigravity CLI (same Google account, free tier available) before then. The MCP Setup Wizard already supports it.

Your keys, your cost.

Most AI tabletop tools route through their servers, mark up the tokens, and meter you per turn. Run out of credits mid-session, too bad. Familiar never proxies, meters, or marks up anything. Your API keys go straight from your browser to the provider. With MCP, your subscription handles it. No middleman, no per-turn limits, no credits to run out.

Combat tracker with initiative order and an active NPC token

Combat & AI

31 tools manage encounters end-to-end: initiative, attacks, spells, damage, conditions, death saves, and XP. Ask Familiar to pilot NPC turns using battlefield snapshots, scored movement with cover analysis, and full action resolution including multiattack and legendary actions.

  • Initiative, turns, and rounds: end-to-end encounter flow
  • Attack rolls, saves, and damage with full automation
  • Conditions, death saves, and XP awards
  • Pilot NPC turns with battlefield snapshots when you want to
  • Scored movement with cover analysis
  • Multiattack and legendary action resolution

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

NPC dialogue panel with TTS playback controls

Voice & Image Generation

Assign unique AI voices to NPCs and bring dialogue to life with multi-voice text-to-speech across three providers. Generate character portraits, item art, and battle map backgrounds on the fly.

  • Give each NPC its own voice
  • Multi-voice text-to-speech across three providers
  • ElevenLabs, Cartesia, OpenAI TTS
  • Generate character portraits on the fly
  • Generate item art and battle-map backgrounds
  • Scene art from text blueprints

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

Scene canvas with placed tokens and lighting

Scenes & Canvas

Create scenes, place tokens, draw walls and doors, set lighting and darkness, add weather effects, and configure trigger regions. Full control over tiles, drawings, ambient sounds, fog of war, and camera.

  • Create scenes and place tokens
  • Draw walls, doors, and trigger regions
  • Set lighting, darkness, and weather effects
  • Configure tiles, drawings, and ambient sounds
  • Fog of war and camera control
  • Spawn tokens from any compendium

Spawn two Wolves from the compendium as reinforcements, place them near the forest edge, and add them to combat with initiative rolled.

Audio mixer with active playlist and ambient track

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.

Journal entry with semantic search results

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. Summarize what happened this session and save it.

Character sheet with inventory and active effects

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 panel running NPC turns automatically

Auto-Pilot

Click "Run NPC" and walk away. 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
  • Walk away while the encounter resolves

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

Transcription panel with color-coded per-speaker lines

Live Transcription

Speak instead of type. Familiar transcribes your session in real time across three providers, color-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 color coding
  • Saves directly to a Foundry journal entry
  • Edit and search the transcript afterward
  • Gladia, Deepgram, AssemblyAI

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

Chat panel showing pinned campaign threads with switcher

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. Familiar runs the DM's side of the table on top of it.

Plays at any table

However many show up, you get to play.

You bought Foundry to run the game for everyone else. Familiar takes the DM's side of the table, the rules, the dice, the monsters, and every NPC in its own voice, so you can take a seat at your own game. The fewer humans at the table, the more of the world Familiar runs.

  • Solo

    Just you

    You play your character. Familiar runs everything around it: every NPC, every monster's turn, the scene, and 2024 D&D 5e enforced for real. 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 plays the supporting cast and runs the encounters, each NPC in its own voice, so you both stay players in the story.

  • 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; Familiar handles initiative, the monster turns, and the bookkeeping. You run the scene, not the spreadsheet.

A co-pilot, not a replacement DM. Whoever is at the table, you are still telling the story, and the dice and the math are always right. No "you rolled a 47."

How it works

One message in. The whole table responds.

No new app to learn. You talk, and Familiar turns it into the Foundry actions you would have clicked yourself.

  1. You talk

    Type in Familiar's chat inside Foundry, or connect an MCP client like Claude, ChatGPT, or Codex. Your AI reads the scene and picks which of the 191 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: roll initiative, place tokens, set lights, cue music. 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 GM who'd rather run the story than the spreadsheet.

I'm Ryan. Dad of two young kids, married to my favorite 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 191 tools across 24 domains and 25 AI providers.

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

One month free. Your keys, your cost.

$3 a month or $25 a year keeps Familiar maintained. Your AI provider bills you directly for what your model actually uses. No markup, no proxy, no per-turn limits.

Feed the Familiar$3per month
Run it for a year$25per yearsave $11

Free for the first month, then $3.

Billed monthly or yearly. Cancel anytime.

Start your free monthor install in Foundry first
  • All 191 tools across every supported Foundry system
  • 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, Ollama, your MCP subscription: you set up the key, they bill you. A typical D&D session runs roughly $0.50 to $3 in API costs depending on the model, or nothing if you use a subscription through MCP or a local model through Ollama.

Common questions

Honest answers.

The questions players and GMs ask most. The full list lives on GitHub.

  • 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. Use Ollama or LM Studio for fully offline play.

  • 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?

    Full support is D&D 5e (2024 rules) only. Generic features like dice, journals, scenes, and audio work everywhere, but system-specific tools (character sheets, combat automation) are built around the dnd5e data model. Pathfinder 2e, Call of Cthulhu, and Savage Worlds are on the roadmap.

  • Which AI models work best?

    Claude Opus 4.8 or Sonnet 4.7, GPT-5.5, and Gemini 3.1 Pro give the best tool-use results today. Grok 4.3, Mistral Large 3, and DeepSeek V3.2 also handle tool-use well. Bring whichever key or subscription you already pay for. Familiar never marks up usage.

  • Can I play solo, or one on one?

    That's one of the main reasons 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?

    Not yet. Familiar runs the DM's side of the table, the rules, the monsters, and the NPCs, so you play your own character. An AI that runs a companion's turns beside you is on the roadmap, not shipped. And the surprises come from the adventure and Foundry's own fog of war, not from the AI keeping secrets. An AI can't truly hide what it can read.

Roadmap

Things I'm working toward.

No promises on timelines. These are the directions Familiar is heading.

Sharper solo and duet play.

For the GM who runs the table for everyone else and wants to play for once. Today Familiar runs the DM side; these extend it.

  • Companion party-fill: let the AI run a designated ally's combat turns
  • 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: automated rolls, animations, loot, effects.

  • Midi-QOL: automated attack rolls and saves
  • 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

More systems, beyond D&D 5e.

Full system-specific tools: character sheets, combat automation, spell resolution.

  • D&D 5e (2024)Shipped
  • Pathfinder 2ePlanned
  • Call of CthulhuPlanned
  • Savage WorldsPlanned

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 month is on the house. Cancel anytime, your world stays yours.

Install in FoundryJoin the Discord