Sentient：本地运行的个人AI助手

Your personal AI assistant, running on your own computer. Long-running tasks, real memory, proactive help, voice, phones and smart glasse…

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 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 Loading 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 liv