Skip to content
Han AI

How Han AI works

Han AI runs on a dedicated Ubuntu VPS that we provision for you. Every workspace is fully isolated: its own server, its own bot, its own Airtable base, its own domain, its own data.

The four pieces

PieceWhat it isWhere it lives
Your VPSUbuntu Linux server running the Han AI runtime, dashboard, and reverse proxy.Vultr, in the region you choose.
Your botDedicated Telegram bot — your only conversational surface.Bot lives in Telegram; messages route to your VPS.
Your dashboardWeb console for status, profile, and learning.https://<your-id>.hanai.systems on your VPS, fronted by Caddy with auto-TLS.
Your dataAirtable base + persistent state on the VPS (/var/hanai/state/).Your Airtable account + your VPS disk.

Two modes

Han AI runs in two modes that share the same conversation history.

Onboarding mode

The first time you message the bot, you’re in onboarding. Han AI walks through a structured profile capture — what your business is, who your clients are, what you need help with, how you like to work. It writes the captured profile to your Airtable base and your VPS state, then signals that onboarding is complete:

All set — activating your system now.

Live mode

After onboarding, every message you send goes to live mode. Each turn:

  1. Han AI builds context from your captured profile, recent history, and available tools.
  2. It calls the language model with the set of tools that are currently available on your VPS.
  3. If the model wants to use a tool — say, search the web, extract a PDF, send an email — Han AI runs the tool on your VPS and feeds the result back.
  4. The model produces a synthesised reply. You see one polished answer, not a JSON dump.
  5. The turn is appended to your persistent conversation log.

What runs every day

Even when you don’t open Telegram, your VPS keeps working:

  • Dreaming loop, 06:30 — Han AI generates 0–3 insights based on recent activity. If confidence is high, it sends them to you. If not, they stay in the log.
  • Tenant brief, daily — a markdown snapshot of your captured profile, recent conversation, capability gaps, and preferences. Useful for catching up after a break.
  • Owner-scheduled crons — anything you’ve asked Han AI to do on a recurring schedule. It just runs.

Approval, not auto-pilot

Han AI never sends an email, makes a payment, or contacts a third party without your sign-off. By default, anything that costs money, talks to another person, or touches data outside your workspace requires you to tap approve.

You can widen the autonomy boundary as trust builds and narrow it any time.

Your data, always yours

  • Your Airtable base belongs to your Airtable account.
  • Your Telegram bot token belongs to you.
  • Your VPS can be transferred to you on exit.
  • Han AI authenticates with the tokens you provide. Revoke them and access stops immediately.

Next