Skip to content

Repository files navigation

exxperts

AI colleagues that learn and remember. On your machine, under your control.

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.

CI License: Apache 2.0 Latest release macOS, Windows, Linux

Download · See it · How it works · Why exxperts · Install · Ways to use it · Docs

Download the app

The easiest way to run exxperts: a desktop app. Download, open, connect your AI provider. No terminal involved.

Download for Mac (Apple Silicon .dmg)    Download for Windows (installer .exe)

Also available: Windows portable zip · macOS zip · checksums on Releases

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.

See it

A three-act tour: ask and the room searches the live web; Remember proposes what to keep and you edit the proposal before approving it; the memory page shows the room's notes by topic and every conversation it memorized

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.

The exxperts launcher: seven persistent rooms from Agent frameworks to Research: local AI and Trip: Japan 2026, each with its own governed memory

The approval gate: a memory proposal shows exactly what the room will remember, and nothing is saved until you approve it

The memory page: how full each room's memory is, its notes by topic, its waiting and memorized conversations, and the growth graph with the budget line

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.

Install

One command installs everything:

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/EXXETA/exxperts/main/install.sh | bash

Windows (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). Re-run the same command anytime to update.

Requirements, troubleshooting, and platform notes
  • 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 and switch); sign in via AI setup in the app. All provider paths: 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.
  • Contributors: git clone + npm install + npm run install:global builds and installs the commands from source; CONTRIBUTING.md has the full setup.

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 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 for heavy use) · a health check (exxperts doctor / in-app) · multi-provider wallet.

Documentation

Quickstart · How exxperts works · Web search · Security & threat model · Desktop app · Contributing · Docs index

License

Apache 2.0. 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) and Fernando Pastor Alonso (@ferpastoralonso) at Exxeta. It is built on Pi by Mario Zechner; the bundled runtime under runtime/ is derived from Pi (v0.70.5, MIT), with the upstream license preserved in runtime/LICENSE and the fork documented in runtime/NOTICE.md. Third-party product names and logos in the connector directory are trademarks of their respective owners (glyphs from Simple Icons, CC0), used for identification only. Contact: borja.odriozola.schick@exxeta.ch and fernando.pastor@exxeta.ch

About

Local-first AI agents with governed, approval-gated memory. Any model provider; MCP tools and web search built in. Nothing remembered without your say-so, nothing leaves your machine.

Topics

Resources

Contributing

Security policy

Stars

358 stars

Watchers

10 watching

Forks

Releases

Packages

Used by

Contributors

Languages