Sentient

[!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

What it does

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.

1. Pick a good first issue or help wanted issue, or fix something that bugs you.
2. Fork, branch from main, and open a small pull request.
3. Checks run automatically, one maintainer review, and it's in.

Read CONTRIBUTING.md. Using an AI coding agent? Point it at AGENTS.md.

Documentation

Looking for the old cloud version? It lives on the v2 branch.

Team

And every contributor. Thank you.

License

Sentient is free software under the GNU AGPL v3. Contributions are accepted under our Contributor License Agreement.