Installation Methods

Xio is designed to be easy to deploy on your own machine. The preferred method is Docker, but advanced users can also run it manually with Node and Python environments.

Docker (Recommended)

This method installs everything you need with a single command.

bashCopyEditgit clone xio
cd xio
docker compose up --build

Once the containers are built and running, open your browser to:

arduinoCopyEdithttp://localhost:3001

Manual Install (Advanced)

If you prefer to run the frontend and backend separately, you can install each component individually.

Install backend:

bashCopyEditcd backend
npm install
npm run dev

Install frontend:

bashCopyEditcd frontend
npm install
npm run dev

You’ll also need a running vector database like Chroma and a configured .env file. This setup gives you full control over each component but is not recommended unless you know what you're doing.