& aaka.

Name it. Claude installs it.
Your family texts it.

A private household assistant. You set it up by talking to Claude; give it a name and it becomes part of the family — texting wherever you already chat: WhatsApp, Telegram, and more.

1
2
❯ Install Aaka from github.com/prasadgupte/aaka-life

Private & yours

Your Google account never leaves your machine. The internet-facing half can run with no credentials at all. No cloud account, no telemetry.

Local or a $5 VPS

Run it on your Mac, or the smallest VPS for always-on. Your data, your hardware, your call.

Under $1 a month

95% of everyday queries read a local file — no AI call, no per-message billing. A whole household runs for under $1/mo. Skylight charges $11.

Any channel, extensible

WhatsApp, Telegram & more. Need a new skill? Ask Claude to add it — it’s just Python.

The problem

Rumi had a dentist appointment at 10:30. Nobody told Tsu.

Alex added it to a calendar. Mentioned it in one WhatsApp thread. Tsu was in a different thread, looking at a different calendar. So Tsu booked a client call over it — and the argument that followed wasn't really about the dentist.

Meet the ash-kaas — a household like yours. We’ll follow them through the rest of this page.

  • AXAlexparent
  • TSTsuparent
  • ARAri11
  • RURumi7
  • KIKirangrandma
  • TATaylorsitter

A household like this coordinates across five apps, and no single one owns the picture. Every new "family app" asks everyone to install something — nobody does. And the AI assistants that could help burn tokens on every "what's on today?", routing your family's private schedule through someone else's cloud.

How they use it

Here’s how everyone chats with Aaka

Alex set it up once by talking to Claude. Now the whole family just texts — in the app they already use. Watch a setup, then a day.

—

—

The install · about 5 minutes

What that one prompt actually does

Claude drives; you answer a few questions and confirm. Here’s the whole flow.

  1. 1

    Claude fetches the code

    It clones the repo and checks prerequisites — Python, your Google account. Nothing is installed system-wide.

    Prefer to do it by hand? git clone the repo and run bash admin/aaka.sh deploy.

  2. 2

    You give it a name

    If you set a name above, Claude uses it; if not, it asks. The name is how it shows up in your family chat, so pick one that feels like a person.

  3. 3

    Connect Google — locally

    You authorize once. The token lives on your machine and the calendar is read and written from home. Nothing is uploaded to us, or to anyone.

  4. 4

    Choose what it can do

    Calendar, tasks, shopping lists, notes, a file inbox — switch on what your household needs. Add more later just by asking Claude.

  5. 5

    Pick a channel

    For Telegram, message @BotFather, tap “New Bot”, and paste the token it gives you when Claude asks — that’s the whole hook-up. Prefer WhatsApp? Scan one QR instead. From then on everyone just texts.

    Claude: Paste your Telegram bot token → you drop in 8143…:AAH… → ✓ bot live.

Runs on your Mac, or the smallest VPS for always-on. Full install guide →

Three pillars

Why Aaka is built this way

01 · attention

One text. Done.

The people you live with don't need another app. Aaka sits between Google Calendar, WhatsApp, and Telegram — using the apps you already have. Type d. Get today's schedule. Type b aldi milk eggs. Done. One letter, one action.

02 · cost

Pennies to run, by design

Common queries — "what's on today?", "show the list", "what flights" — cost exactly zero tokens. They read local files. The LLM is only invoked when language really has to be understood. A household of six runs Aaka for under $1/month.

03 · privacy

Privacy by architecture

Aaka splits into Away (a small VPS that receives messages and detects intent) and Home (your machine, which holds your Google account and writes to your calendar). Your account lives at home; the satellite can't reach it, and by default holds no credentials at all. This isn't a privacy policy — it's the architecture.

Architecture

Your account lives at home.
The satellite can't reach it.

Away VPS · ~$5/mo receives messages detects intent · queues actions optional: scoped throwaway token queue (sqlite) replies Home your Mac or Linux box holds your Google account writes Google Calendar · local files WhatsApp · Telegram Google Calendar · OAuth No credentials by default. Your account only ever acts from home.

Most interactions never leave the first branch: schedule reads, list reads, note appends — all served from plain markdown on your disk. Zero tokens, instant. The LLM is a scalpel, not a sledgehammer.

Your real Google account stays home. The internet-facing half opens no inbound port and, by default, holds no credentials: it queues requests and reads only the digests your machine pushes to it. Give it a scoped throwaway token and it answers more on its own. Either way, what a compromised VPS can reach is that token, never your account. Your machine talks straight to Telegram and your calendar with plain Python you can read — your infrastructure, top to bottom.

What it does

One-thumb commands. Most cost zero tokens.

Single-letter aliases because / isn’t on the default mobile keyboard. Pick one and watch it play out.

    & aakaonline
    For builders — it's live

    Install it now, by talking to Claude

    Paste one line into Claude Code and it clones, configures, and stands it up for your household. AGPL-3.0. No telemetry. No account.

    Install Aaka from github.com/prasadgupte/aaka-life
    Star on GitHub → (opens in a new tab)

    Built by Prasad Gupte — because "I told you about the dentist" is not a scheduling system.

    Who's behind it

    An engineer, first.

    aaka is built by Prasad Gupte — years shipping production software, open-source contributions to the Symfony framework, and a lot of building in the trenches.

    He gives back the way engineers do: mentoring, and code you can actually read.

    More about Prasad →
    Hosted · updates · or just say hello

    Get in touch

    Want us to host it, want launch updates, or just have a question? Pick a topic and drop a line. Hosted is EU-hosted, encrypted at rest, cancel anytime.