Run Family Drill from one conversation.

Add relatives by telling the bot their names and email addresses in the bot chat. There is no hosted website form for adding family members. Your family members do not need to set anything up.

Install the Family Drill bot →

The easy path

1. 1
   Install the bot

   Install the published Family Drill bot.

2. 2
   Verify your email

   Open https://app.familydrill.com/login and verify your organizer email.

3. 3
   Copy the install code

   After verification, you'll land on the page with your install code.

4. 4
   Connect the bot

   Paste the install code into the bot chat.

5. 5
   Add your family in the chat

   Tell the bot each relative's name and email address. There is no hosted website form for adding family members.

6. 6
   Send and review

   The bot sends the drills. Return to the bot chat to review what happened.

Hosted or self-hosted

Hosted: sign in at https://app.familydrill.com/login. After you verify your email, you'll land on your install code. No app deployment or email-provider setup is required.

Self-hosted: clone the repository, run the app on your own domain, and connect your own email service when you are ready to move beyond the included console-only mail adapter.

Practice, not phishing

Every drill uses a fictional organization, never a real brand or sender identity.

A reveal teaches the clues and never harvests credentials, financial details, or other secrets.

Bot builders: see docs/bot-api.md in the repository.