Installation
Xagent supports multiple deployment options depending on your needs.pip / uv (single machine)
The lightest way to run Xagent on your own machine — no Docker, no Node, no external services. The published package bundles the web UI and defaults to SQLite, so a single command starts the whole thing.Requires Python 3.11+.
uv tool install puts Xagent in its own isolated environment. With pip, install into a virtual environment as shown — a global pip install fails with an externally-managed-environment error on Python 3.11+ (PEP 668).uvx:
http://127.0.0.1:8000, create your admin account at /setup, and configure an LLM provider.
To use a provider without the UI, put a key in a .env file in the working directory (or export it):
Data is stored under
~/.xagent (SQLite) — no PostgreSQL or Redis needed for single-machine use. Override the location with XAGENT_STORAGE_ROOT. For multi-user / team deployments, use Docker Compose below.Docker Compose (Recommended)
The fastest way to get started.http://localhost:80
Manual Installation
For more control over your deployment.Requirements
- Python 3.10+
- PostgreSQL 14+
- Redis 6+
Backend Setup
Frontend Setup
Configuration
See Configuration for detailed setup options.Production Deployment
For production deployments, see:System Requirements
Minimum
- CPU: 4 cores
- RAM: 8 GB
- Disk: 20 GB
Recommended
- CPU: 8+ cores
- RAM: 16+ GB
- Disk: 50+ GB SSD