Personal AI assistant.
Sona runs on your computer and works with you there — your files, your tools, the work you don't want leaving the machine.
curl -fsSL https://tnsai.dev/install/sona.sh | bash
What Sona is.
A personal assistant on this machine — built with TnsAI.
Install it, talk in the terminal, add Telegram or email when you want them. Everything stays under ~/.sona/ — history, audit log, pairing state, profile. Local providers are first-class; remote ones are opt-in.
Every LLM call writes to ~/.sona/audit.jsonl with model, latency and token counts. Prompt text is off by default. No telemetry unless you wire the exporter.
Three commands to a conversation.
The installer drops the JAR, a JRE if you need one, and puts sona on your PATH. The terminal is enough to start.
curl -fsSL https://tnsai.dev/install/sona.sh | bash
sona init
sona chatThe curl still hits TnsAI because shipped Sona asks for that URL.
How it works.
01
Install
02
Init
03
Chat
On your machine.
Your machine, your data
History, audit log, pairing state and profile live under ~/.sona/. No telemetry unless you wire the opt-in OTLP exporter.
One assistant, every channel
CLI, Telegram, email, Slack, Discord and WhatsApp share the same skills and the same memory. Enable what you use.
Unknown senders stay out
Pairing is on by default. A stranger on Telegram does not reach the model until you allow them.
Built on TnsAI
The Java agent runtime underneath — roles, tools, channels — so Sona is a product, not a prompt file.
One memory, every channel.
Enable what you use. Pairing stays on until you allow a sender.
sona chat on this host.
A bot you already have, or one you create.
IMAP in, SMTP out.
Workspace app, same memory.
Guild bot, same skills.
When you enable it.
Start with the quickstart.
The quickstart takes you from install to a conversation.