Getting started
Introduction.
Xome is a local-first AI agent that runs in your browser, it connects to your apps, works on your files, and can act on-chain with a wallet you fully control.
What makes it different
- Local-first. Conversations, memory, API keys, connection tokens, skills, and your wallet live in your browser's storage (IndexedDB), not on our servers.
- Your model, your choice. Run a model fully on-device via WebGPU, or bring your own Claude / GPT / Gemini key. Keys are forwarded per-request through a stateless proxy and never stored server-side.
- Acts with approval. Reads run freely; every write, sending an email, posting a message, writing a file, moving money, shows a consent sheet first.
- Crypto-native. A non-custodial Solana wallet (embedded via Privy) lets the agent check balances, send tokens, and swap via Jupiter, all signed client-side.
- Extensible. Teach it repeatable workflows with Skills, plug in any MCP server, and let it work on a local folder you pick.
The pieces
The app at app.xome.bot is a Next.js web app. Everything intelligent happens client-side: the agent loop (plan → call tools → reflect), the tool registry, and storage. The only server-side code is a set of stateless proxies that attach your credential to a single outbound request and forward it, nothing is persisted or logged.
Xome is open source. The web app lives at github.com/The-x-35/xome-webapp , you can run the whole thing yourself. See Self-hosting → Run it locally.
Where to go next
- Using the hosted app: start with Quick start.
- Running your own: jump to Self-hosting.
- Hacking on it: read Architecture, then Adding tools.