🤝 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

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...