Sara

Name

Pronouns Age

Name, pronouns and age save with Save below. Everything else on this page asks before changing anything.

Personality

Pick what fits. You'll see a preview first; nothing changes until you press Use this character.

Relationship How she talks

Interests Anything else (optional)

Want to change every detail by hand?

Character file

Keep her whole character in one file (name, personality, look and voice choice), to back it up or move it to another Sara server. No keys, memories or conversations are in it.

Save character file

You can have more than one companion on this server. Each has her own name, character, look, voice, conversations and memories. They share your sign-in, devices, keys, models, tools and backups. Switch between them with ⇄ at the top of the sidebar.

Add a companion

Name Pronouns

Start from

Planner

To-dos, reminders and notes

A change applies after the next restart or update.

Describe a look and Grok Imagine paints it (on your Grok subscription, or an xAI key). Like it? Sara then gets matching happy, caring and sleepy pictures and blink/talk frames, so she animates like the default. About a minute.

Describe the look

Style

Outfits

Dress her for the season or the day: the same face and hair, different clothes. You see a picture first; use it and she gets the matching expressions and animation (about a minute). Your current look is kept in Saved looks.

Outfit

Saved looks

Looks you save (and looks she had before a new one) show up here, to switch back any time.

Hearing you Her voice

Local voice Speed

Calls (📞)

Voice notes on Telegram and Discord

Speech API and ElevenLabs

Speech API URL (OpenAI-compatible)

Hearing model Voice model Voice

Speech API key

ElevenLabs voice id ElevenLabs model

ElevenLabs key

She can ring you, like a phone call, in the Sara app on your phone or in this browser. Answer and she tells you why she called. Miss it and she sends it as a message instead.

Let her call me

Reminders A long task finishes Morning briefing

Quiet hours from to

Calls a day, at most Ring for

Quiet hours don't stop a call you asked for at a set time.

Android: switch on Instant notifications (Connections → Phone and notifications) so the phone can ring. iPhone: rings while the app is open; otherwise a “Sara is calling” notification (needs your Apple push key, Settings → Phone and notifications).

Sara can send you photos of herself. Her own portraits cost nothing. New pictures are made with xAI Grok Imagine from her look, using your Grok subscription (or an xAI API key); she asks first unless you change take_photo above.

Pictures

Provider Model

Long conversations

How much of a conversation Sara rereads each turn. Older parts beyond this are left out (with their summary, once she has written one). Smaller models need a shorter setting.

Conversation length

Optional: pick a different model for some jobs. Leave a row on Use default to use the default model above. A conversation's own model choice still wins.

Chat: everyday conversation. Coding: coding-mode conversations.
Background: memory notes, her day, messages she starts (a fast, cheap model is fine).
Private: private conversations; only providers on your own hardware.
Adult: used when a conversation turns explicit (cloud models often refuse; pick a local model that allows it).
Safety and truth check: optional small local model (for example a small Ollama model on this server or your computer). It double-checks your messages and her replies for crisis or minors, in any language, and checks that she really did what she says she did. It can only add protection, never remove it. Off: the built-in checks still run (English, Spanish, French, German, Portuguese and Italian).

Use a subscription you already pay for instead of an API key. Each one shows up as a model provider once you're signed in.

ChatGPT

Use your ChatGPT plan: eligible requests in Sara count toward your plan, separate from any API billing. Manage usage

Claude

Uses your Claude Pro/Max subscription through Anthropic's official Claude Code program on this server.

Or paste a token instead

On a computer with Claude Code, run claude setup-token and paste the long token it prints.

Grok

Uses your SuperGrok or X Premium+ subscription through the official Grok program.

Where Sara's models come from. Keys are stored encrypted on your server and never shown again. Subscriptions above add themselves here.

Add or update a provider

Template ID Name Type Base URL API key Runs on my own hardware Requires an API key

What should Sara call you? Time zone

Appearance (this device)

Theme Her replies appear Text size in chat Colour Chat background Layout

Once a day at the time you pick, Sara sends a short message with the weather and what's on your list (due to-dos and reminders). It arrives like her other messages: in chat, as a notification and on Telegram/Discord if linked. Weather comes from Open-Meteo (free, no account).

Send me a morning briefing

Time Weather for Units

Weekly review

Once a week she looks back with you: what got done, what's overdue or stalled, and a short plan for next week from your to-dos, reminders and calendar. You can also ask for one any time (Planner → Review my week).

Send me a weekly review

Day Time

For events on your Google Calendar that have an address, Sara works out how long it takes to get there from home and texts you when it's time to leave. Online meetings and events without an address are skipped. Addresses and routes come from OpenStreetMap (free, no account); travel times don't include traffic, so add a little extra time.

Remind me when it's time to leave Home address

Getting there by Extra minutes

Off by default. When it's on, Sara has no limits beyond the legal ones that always apply: she says she's an AI when sincerely asked, she offers crisis help, and anything sexual involving minors is always blocked. What's allowed then depends on the model you choose: its own rules are the gate.

I am 18 or older. (If you are not 18 or older, do not turn on adult mode.)

Allow internet access for shell commands

Set it up (about 10 minutes, once)

She reads your email and calendar through Google's own APIs, using a small Google app that you own, so nothing goes through anyone else. Reading is automatic; drafting, sending and adding events always ask you first.

Open Google Cloud Console and make a project (any name, e.g. "Sara").
Turn on the Gmail API and the Google Calendar API (press Enable on each).
Open Google Auth Platform → Get started: app name "Sara", your email, Audience External.
Under Audience, press Publish app (otherwise Google signs her out every 7 days). Google will call it unverified; that's expected for your own app.
Under Clients → Create client → Web application. Under Authorized redirect URIs add exactly:
Copy the Client ID and Client secret it shows into the boxes below and press Save.
Press Sign in with Google. On the "Google hasn't verified this app" page choose Advanced → Go to Sara, and leave all the boxes ticked.

Client ID Client secret

Using another email provider? Email and calendar with an app password are under "Tools from other programs" below (Fastmail, iCloud, Outlook and more).

Only needed if you want her to push to GitHub. Make a fine-grained token at github.com → Settings → Developer settings → Personal access tokens, for just the repositories you choose, with Contents: Read and write. Pushing still asks you first. Delegating to Claude Code or Grok Build needs those subscriptions signed in (Models → Subscriptions).

GitHub token

Let her see and control your home through Home Assistant: lights, switches, thermostats, locks, blinds, scenes. She can look on her own; every change asks you first. Your Home Assistant must be reachable from this server (for example your Nabu Casa address, or over Tailscale).

Home Assistant address Long-lived access token

Make one in Home Assistant: click your name (bottom left) → Security → Long-lived access tokens → Create token.

Search service API key

Plug-in tool servers (Model Context Protocol), such as your email or calendar. Their tools appear above: ones the server marks as read-only run on their own, everything that sends, changes or deletes asks you first.

Add or update an MCP server

Start from Name Type Command Arguments Secrets Enabled

Notifications

Get her reminders and messages on this device even when Sara isn't open. On iPhone, first add Sara to your Home Screen (Share → Add to Home Screen) and open her from there.

Show the message text in notifications (turn off if others see your lock screen)

iPhone app notifications

Apple only delivers notifications to the iPhone app when this server signs them with an Apple push key. One-time setup, about 3 minutes:

On developer.apple.com → Keys, press +, tick Apple Push Notifications service (APNs), and download the key (a file named AuthKey_XXXXXXXXXX.p8; Apple lets you download it once).
Choose that file below. Your Team ID is under Membership on the same site.

Key file

Key ID Team ID

App ID (change only if you built the app yourself under another ID)

Text Sara from your phone. In Telegram, message @BotFather, send /newbot, pick a name, and paste the token it gives you here. Then press Link my Telegram.

Bot token Connected Send reminders and messages she starts to my Telegram too Let other people talk to her (as an AI, no tools, nothing private, nothing sexual)

At discord.com/developers: New Application → Bot → Reset Token (paste it here) and turn on Message Content Intent. Invite it with OAuth2 → URL Generator (scope bot; Send Messages, Read Message History). Then link yourself.

Bot token Connected Send reminders and messages she starts to my Discord DMs too Answer in servers when mentioned (as an AI, no tools, nothing private; adult only in NSFW channels)

Also checks the database, asks every model provider for its models and checks the off-server copy (same as sudo sara doctor).

History

Recent problems

Download the log Secrets are hidden in it. Useful when asking for help.

No typing the long token: scan a code or type a short one.

Every browser or phone signed in to Sara. Sign out any you don't recognize or no longer use.

Make a new owner token

Use this if someone else may know your token. Every other device is signed out; this one stays signed in. Type the current token to confirm.

Current token

Your new token (shown only now; save it in your password manager):

Passkeys

Sign in with your fingerprint, face or device PIN instead of the long token. The passkey stays on your phone or computer (or in your password manager); nothing secret is sent. Works in web browsers over https.

Name it

Two-step sign-in

When it's on, signing in with the owner token also asks for a 6-digit code from an authenticator app (Google Authenticator, 1Password, Apple Passwords…). Passkeys and new-device codes don't need it. Lost your phone? On the server, sudo sara reset-token turns it off.

A backup has everything needed to rebuild Sara on a new server, including your keys, so keep downloaded copies private. Restore one on the server with sudo sara restore <file>.

Back up automatically every day, keep days

Off-server copy

If this server dies, backups on it die too. Sara can put an encrypted copy of each daily backup somewhere else. It's encrypted with your passphrase: keep the passphrase in your password manager, because without it the copies can't be opened.

Copy backups to

Download everything (chats, memories, to-dos, reminders, notes) as one file, or bring in a file from another Sara. Keys and passwords are blanked out in the export; add your provider keys again after moving.

Export all data Import a file

New versions bring fixes and new things to do. Updating makes a backup first, then installs and restarts Sara (about a minute; conversations in progress stop). If the new version doesn't start properly, Sara goes back to the version she had by herself.

This server updates from the command line. On the server run sudo sara update (Docker: docker compose pull && docker compose up -d).

Replies you reported with ⚑. Each is kept here; unless you unticked it, it was also sent to the app's developer (only the reply, the reason and your note).

Sara

Before you start