Self-hosting

Run it locally.

Clone the repo, install, run. The core app works immediately with zero configuration.

Prerequisites

Node.js 20+ and npm
Chrome or Edge for the full experience (WebGPU on-device models, folder access). Cloud models work in any modern browser.

Install & run

Terminal

git clone https://github.com/The-x-35/xome-webapp
cd xome-webapp
npm install
npm run dev        # http://localhost:3000

That's it for the core app. Working with no configuration at all: on-device models, cloud models with a pasted key, Notion (pasted token), MCP servers, the Solana wallet features that don't need your own infra, skills, local folder workspace, and all the keyless web tools (search, fetch, weather, currency, calculator…).

What needs configuration

1
Copy the env template
cp .env.example .env.local, every variable is documented inline. See the Environment variables page for the full reference.
2
OAuth apps (Google, Slack, GitHub)
Each provider needs an OAuth app registered with your redirect URI before its Connect button works. Until then the UI shows an honest “not configured” message. See OAuth setup.
3
Solana (Privy + RPC)
Set NEXT_PUBLIC_PRIVY_APP_ID to enable wallet connect, and optionally SOLANA_RPC_URL for a reliable RPC. See Solana setup.

Local-first means your instance stores nothing server-side either, users of your deployment keep their data in their own browsers. The server code is only stateless proxies.

Production build

Terminal

npm run build
npm run start      # serves on :3000