Your personal assistant, running on your own computer.
It runs long tasks for you, remembers what matters, notices things before you ask, and talks with you by voice.
Any model, local or cloud. No account, no servers, no setup files.
Get started · Docs · Contribute · Discussions · Roadmap
[!NOTE] Sentient v3 is in alpha. It runs from source, its tests run on Windows and Linux on every change, and a Windows installer builds from this repository. Here is exactly what has been tested.
Why Sentient
🔒 Yours
Everything lives in one folder on your computer. Keys stay in your system keychain. Run it on a free local
model and nothing leaves your machine. No account, no telemetry.
⏱️ Works while you're away
Describe a job in plain words. Sentient plans it, asks you once, then runs it now, on a schedule, when an email
arrives, or whenever a watched price drops.
🧠 Gets to know you
It remembers what you tell it, builds a picture of your preferences and goals that you can correct, and tidies
its memory every night.
📱 Goes where you are
Talk to it with "Hey Sentient", message it on Telegram, and pair your phone or smart glasses so it can see,
speak and reach you anywhere.
What it does
Long-running tasks
One-off, recurring, triggered by your apps, or split across parallel helpers. Every run keeps a live log and a
clear report, and failed runs can be retried from where they stopped.
Watchers that cost nothing
"Tell me when this changes" becomes a tiny script that checks on a schedule and only wakes the AI when
something happens.
About you
How Sentient understands you, with the reasons behind each thing it noticed. Confirm it, correct it, or tell it
it's wrong.
It tidies up overnight
Each night it merges duplicate memories, settles contradictions (an old "lives in Chennai" gives way to
"lives in Bengaluru") and writes a short journal of what changed.
Phones and smart glasses
Pair a device with a six-digit code. Sentient can show text, speak, check where you are, or take a photo and
tell you what it sees. The [protocol](docs/NODES.md) is open, with reference glasses firmware.
Voice, hands-free
Say "Hey Sentient", talk naturally and interrupt whenever you like. Speech recognition runs on your computer.
Learns new skills, with your OK
After real work Sentient writes reusable skills, and proposes fixes when one goes wrong. Nothing changes until
you approve the diff.
Any model, any job
Pick a model for chat, background work, planning, voice and vision. Mix free local models with your own cloud
keys, and test each one with a click.
And more: Gmail, Calendar, Drive, Docs, Sheets, GitHub, Slack, Notion, Trello, Discord, WhatsApp, Home Assistant and any MCP server · near-instant updates from Gmail and Calendar, IMAP push and webhooks · proactive suggestions you approve or dismiss · browser control on your own Edge or Chrome · code that runs in a sandbox · helper agents that work beside the chat · messages you can add while it is still answering.
Get started
Windows: build the installer with cd desktop && npm run package and run desktop/dist/Sentient-Setup-*.exe.
Prebuilt, signed downloads are coming with the first public release.
From source (Windows, macOS, Linux) with Python 3.12, uv and Node 22:
git clone https://github.com/existence-master/Sentient.git && cd Sentient
uv venv .venv --python 3.12
uv pip install --python .venv/Scripts/python.exe -e ".[voice]" # macOS/Linux: .venv/bin/python
cd desktop && npm install && npm run dev
Then pick a brain: install Ollama and run ollama pull qwen3:8b for a free, private
model, or paste your own Anthropic, OpenAI or Gemini key. The app walks you through the rest.
Getting started has first things to try and troubleshooting.
How it works
flowchart LR
subgraph you["Where you are"]
app["Desktop app"]
phone["Phone"]
glasses["Smart glasses"]
chat["Telegram · Discord"]
end
subgraph engine["Sentient engine, on your computer"]
agent["Agent loop"]
tasks["Tasks and scheduler"]
memory["Memory and user model"]
proactive["Proactivity and skills"]
tools["Tools: apps, browser, code, devices"]
db[("One SQLite file")]
end
local["Local model (Ollama)"]
cloud["Cloud model (your key)"]
apps["Your apps"]
app <--> agent
phone <--> agent
glasses <--> agent
chat <--> agent
agent --- tasks & memory & proactive & tools
tasks & memory & proactive --> db
agent --> local
agent -.-> cloud
tools <--> apps
The desktop app starts a local Python engine. One agent loop powers chat, tasks, helpers, proactivity and voice, and everything is stored in a single SQLite file. Read the architecture, the API contract, and the decision records that explain why it is built this way.
Privacy and safety
- On a local model, nothing leaves your computer. With a cloud model, only what each request needs goes to the provider you chose.
- Sentient asks before it sends, deletes, buys or runs code. Purchases always ask.
- It never types passwords or card numbers. You sign in to websites yourself.
- Code it writes runs without your keys. Device photos ask first. Only paired chats can message it.
Details in Privacy. Found a vulnerability? Please report it privately: SECURITY.md.
Contributing
You never need our API keys: Sentient runs on a free local model or your own key, and every test runs offline with a fake model.
- Pick a good first issue or help wanted issue, or fix something that bugs you.
- Fork, branch from
main, and open a small pull request. - Checks run automatically, one maintainer review, and it's in.
Read CONTRIBUTING.md. Using an AI coding agent? Point it at AGENTS.md.
Documentation
| Getting started | Install, choose a model, first steps, troubleshooting |
| Privacy | What stays on your computer and what leaves it |
| Developing | Run, test, capture screenshots, build installers |
| Architecture · Decisions | How it fits together, and why |
| API contract | Everything the app and the engine exchange |
| Devices protocol | Build your own device or firmware |
| Verification · Roadmap · Changelog | What's tested, what's next, what changed |
Looking for the old cloud version? It lives on the v2 branch.
Team
[
Sarthak (itsskofficial)](https://github.com/itsskofficial)
[
kabeer2004](https://github.com/kabeer2004)
And every contributor. Thank you.
License
Sentient is free software under the GNU AGPL v3. Contributions are accepted under our Contributor License Agreement.