exxperts

<div align="center"> <picture> <source media="(prefers-color-scheme: dark)" srcset="docs/assets/exxperts-logo-negative.png"> <img src="docs/assets/exxperts-logo.png" alt="exxperts" width="360" align="center" /> </picture> </div> <p align="center"><b>AI colleagues that learn and remember. On your machine, under your control.</b></p> <p align="center">Local-first AI agents with governed, approval-gated memory. Works with any model provider; MCP tools and web search built in. Nothing remembered without your say-so, nothing leaves your machine.</p> <p align="center"> <a href="https://github.com/EXXETA/exxperts/actions/workflows/ci.yml"><img src="https://github.com/EXXETA/exxperts/actions/workflows/ci.yml/badge.svg" alt="CI" /></a> <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-8CA5FF" alt="License: Apache 2.0" /></a> <a href="https://github.com/EXXETA/exxperts/releases"><img src="https://img.shields.io/github/v/release/EXXETA/exxperts?include_prereleases&color=EBFF59" alt="Latest release" /></a> <img src="https://img.shields.io/badge/platform-macOS%20%7C%20Windows%20%7C%20Linux-46DCFF" alt="macOS, Windows, Linux" /> </p> <p align="center"> <a href="#download-the-app">Download</a> · <a href="#see-it">See it</a> · <a href="#how-a-room-grows">How it works</a> · <a href="#why-exxperts">Why exxperts</a> · <a href="#install">Install</a> · <a href="#ways-to-use-exxperts">Ways to use it</a> · <a href="#documentation">Docs</a> </p> ## Download the app The easiest way to run exxperts: a desktop app. Download, open, connect your AI provider. No terminal involved. <p align="center"> <a href="https://github.com/EXXETA/exxperts/releases/latest/download/exxperts-desktop-mac-arm64.dmg"><img src="docs/assets/download-mac.png" alt="Download for Mac (Apple Silicon .dmg)" width="300" /></a> &nbsp;&nbsp; <a href="https://github.com/EXXETA/exxperts/releases/latest/download/exxperts-setup-win-x64.exe"><img src="docs/assets/download-windows.png" alt="Download for Windows (installer .exe)" width="300" /></a> </p> <p align="center">Also available: <a href="https://github.com/EXXETA/exxperts/releases/latest/download/exxperts-desktop-win-x64.zip">Windows portable zip</a> · <a href="https://github.com/EXXETA/exxperts/releases/latest/download/exxperts-desktop-mac-arm64.zip">macOS zip</a> · checksums on <a href="https://github.com/EXXETA/exxperts/releases">Releases</a></p> Both builds are signed. The macOS app is notarized by Apple and opens clean; the Windows installer is publisher-verified as Exxeta AG. While a release is new, Windows SmartScreen may show a one-time notice: *More info* shows the verified publisher, then *Run anyway*. Prefer a terminal? See [Install](#install). ## See it  Every note shows **when it was saved** and which conversation it came from, and every memorized conversation opens as it was stored. The growth chart is clickable time travel: pick a day, read everything your AI knew then.    ## How a room grows **Work.** A room replaces a chat thread: it is the durable place where you set up your exxpert's tools, folders, connections, and skills - and the exxpert in it searches the web, reads pages, writes documents, decks and web pages, and runs background tasks. Which tools each room may use is your call. **Remember.** At the end of a conversation, the room proposes what is worth keeping. You steer it, edit it, or reject it; nothing enters memory without you. **Memorize.** The room turns remembered conversations into lasting notes, grouped by topic, and shows you what it will keep before anything is saved. Notes that no longer fit move to an archive the room can still read, never to the bin. This is how a room stops being a tool and starts becoming a colleague: conversation by conversation, it knows more of your work. Every memory traces back to the conversation it came from, and everything a room is lives as plain files on your machine. Switch AI providers anytime, and you keep the colleague. ## Why exxperts - **Memory is opt-in, not automatic.** The AI remembers only what you explicitly approve: every proposed memory passes a review gate before it's written. - **Every memory has a receipt.** Each note carries the day it was saved and the conversation it came from, every change is in History with what changed, and time travel shows exactly what your AI knew on any given day. - **You can see what the model saw.** The full context behind any answer is inspectable, so replies can be audited rather than taken on faith. - **Memory you can correct.** Edit, move, pin, archive or restore any note by hand, and undo the last memory save; wrong facts don't fossilize. - **Everything lives on your machine.** Memory, conversations, credentials, and the files you attach or a room creates: plain files on your disk, under your control. No cloud account, no telemetry; nothing leaves your machine unless you send it. The optional remote mode (off by default) only ever serves your own paired devices over your private tunnel; there is no cloud in between. - **No provider lock-in.** Claude, ChatGPT, Gemini, Mistral, or any OpenAI-compatible endpoint, including local models; switching keeps everything your AI has learned, and a provider outage never strands your work. Most local AI tools are chat interfaces with hidden state. exxperts is built around governed memory: lean by design, and the more you work with it, the sharper it gets. How well a room answers from that memory, against having the whole history in the prompt, is measured in [docs/memory.md](docs/memory.md#how-well-it-works-measured). ## Install One command installs everything: **macOS / Linux** ```bash curl -fsSL https://raw.githubusercontent.com/EXXETA/exxperts/main/install.sh | bash ``` **Windows (PowerShell)** ```powershell irm https://raw.githubusercontent.com/EXXETA/exxperts/main/install.ps1 | iex ``` Then run `exxperts web`: your browser opens, signed in. Web search is built in via DuckDuckGo, no setup needed ([limits](docs/web-search.md)). Re-run the same command anytime to update. <details> <summary>Requirements, troubleshooting, and platform notes</summary> - Prebuilt archives (bundled runtime, checksum-verified) for macOS Apple Silicon, Windows x64, Linux x64; everything else builds from source automatically (needs Git + Node.js ≥ 20.6). - An AI subscription (Claude or ChatGPT) or any API key / OpenAI-compatible gateways (save several; each room picks its models in Room settings, Model); sign in via **AI setup** in the app. All provider paths: [docs/provider-setup.md](docs/provider-setup.md). - `exxperts doctor` checks any install and prints the fix for whatever's missing. - Windows notes, corporate networks, per-user Git installs, PowerShell policies, proxy/TLS: see [docs/quickstart.md](docs/quickstart.md). - Contributors: `git clone` + `npm install` + `npm run install:global` builds and installs the commands from source; [CONTRIBUTING.md](CONTRIBUTING.md) has the full setup. </details> ## Ways to use exxperts One product, one shared brain (`~/.exxperts`), several doors; open whichever fits the moment: | Door | Get it | Updates | Terminal needed | |---|---|---|---| | **Desktop app** | [Download above](#download-the-app) | Check for Updates installs and restarts in one click; the app also asks the GitHub releases feed for the newest version at launch and every six hours, which only shows a notice, nothing installs by itself | Never | | **Browser** (`exxperts web`) | One-liner above · or *Open in Browser* from the app | Re-run the one-liner | To start it | | **Terminal** (`exxperts cli`) | Same install | Same | Yes | | **Clone & build** | `git clone` | `git pull` | Yes | The app is self-contained and always runs its own version; a terminal install updates separately. Already installed via the terminal? **The app uses the same data, just download and open it.** Only one server runs at a time, whichever door you opened. ### What's inside Persistent rooms with governed memory · artifacts (documents, decks, pages your rooms produce) · delegated background tasks · skills · MCP connectors · scheduled work · web search (rooms on Claude and ChatGPT search through the provider itself, gateway models through their gateway where marked, everything else through the built-in search: DuckDuckGo with no setup, or [SearXNG](docs/web-search.md) for heavy use) · a health check (`exxperts doctor` / in-app) · multi-provider wallet. ### Documentation [Quickstart](docs/quickstart.md) · [How exxperts works](docs/how-exxperts-works.md) · [Web search](docs/web-search.md) · [Security & threat model](SECURITY.md) · [Desktop app](apps/desktop/README.md) · [Contributing](CONTRIBUTING.md) · [Docs index](docs/README.md) ### License [Apache 2.0](LICENSE). Free for personal and commercial use. This repository is the exxperts Community Edition; an Enterprise version is in the works. exxperts is designed and built by **Borja Odriozola Schick** ([@borcho23](https://github.com/borcho23)) and **Fernando Pastor Alonso** ([@ferpastoralonso](https://github.com/ferpastoralonso)) at [Exxeta](https://exxeta.com). It is built on [Pi](https://github.com/badlogic/pi-mono) by Mario Zechner; the bundled runtime under `runtime/` is derived from Pi (v0.70.5, MIT), with the upstream license preserved in [`runtime/LICENSE`](runtime/LICENSE) and the fork documented in [`runtime/NOTICE.md`](runtime/NOTICE.md). Third-party product names and logos in the connector directory are trademarks of their respective owners (glyphs from [Simple Icons](https://simpleicons.org), CC0), used for identification only. Contact: borja.odriozola.schick@exxeta.ch and fernando.pastor@exxeta.ch