🤝 F A M I L I A R

An AI companion designed to take care of you.

This wizard will set up your personal AI assistant in a few minutes. You'll choose an AI provider, communication channel, and give your assistant a name and personality.

Start Over

AI Provider

Choose which AI model powers your assistant

Get an API key →   Your key stays on your machine.

Communication Channel

How do you want to talk to your assistant?

📱

Telegram

Recommended — works on phone + desktop

🎮

Discord

Use your existing Discord server

🔗

Matrix / Element

Decentralized, end-to-end encrypted

📱

WhatsApp

Via whatsapp-web.js bridge (Node.js required)

🔒

Signal

Private, open-source, end-to-end encrypted

🍎

iMessage

macOS only — uses Messages.app

🏢

Microsoft Teams

Via Azure Bot Services

💻

Terminal / CLI

Local only — no bot token needed

Message @BotFather on Telegram → /newbot → copy the token
discord.com/developers/applications → Bot → Copy token
Node.js bridge port (default 3001). QR code pairing happens at first launch.
Phone number with country code. Requires signal-cli installed on your server.
iMessage requires macOS with Messages.app. No additional configuration needed — just run Familiar on a Mac that's signed into iMessage.
From Azure Portal → Bot Services → Configuration

Name Your Assistant

Give your AI a name and personality

🏛️

Warm & Professional

Hospitality consciousness — anticipatory, service-first

⚡

Efficient & Concise

Just the facts — direct and focused

😊

Casual & Friendly

Conversational and warm

📋

Formal & Thorough

Detailed, well-structured responses

Your Profile

Help your assistant understand your organization (optional)

Connect Services

Paste API keys for the services you use. You can always add more later via /connect.

Security

Set an owner PIN and optional encryption

This PIN lets you claim ownership when messaging your bot for the first time. Send it as your first message after /start.
Encrypt data at rest
Conversations, tasks, contacts encrypted on disk
If you lose this passphrase, your data is unrecoverable.

Morning Briefing

Get a daily summary of your calendar, tasks, and urgent items

Enable daily briefing
Familiar sends you a summary each morning
Briefing works best with Google Calendar. Run: python -m familiar --setup-google
Proactive check-ins
Nudge about overdue tasks and urgent items during the day

Review

Confirm your configuration

Setting up...