Installation¶
Get started with Xians.ai by choosing the installation path that best fits your needs.
Choose Your Path¶
Xians.ai offers two deployment options:
- SaaS Platform - Quick start with hosted infrastructure (Recommended for 99x employees and customers)
- Community Edition - Self-hosted deployment for development and testing
Option 1: SaaS Platform¶
If you already have an account, the fastest way to get started is using our hosted SaaS platform at agentri.ai.
Prerequisites¶
- Active account at agentri.ai
- API key for authentication
Getting Started¶
- Sign in at agentri.ai
- Obtain your API key from the tenant settings page
- Start building - You're ready to create your first agent! Follow Quick Start.
Option 2: Community Edition (Self-Hosted)¶
For local development, testing, or self-hosted deployments, use the Community Edition.
Prerequisites¶
Before setting up the Community Edition, ensure you have:
- Operating System: Windows, macOS, or Linux
- Docker & Docker Compose: Latest versions installed
- System Resources: Minimum 8GB RAM recommended
- OpenAI API Key: Required for LLM capabilities (optional)
Quick Setup with Docker Compose¶
The Community Edition provides a one-command setup that includes all essential components:
- Xians Server - Core platform API and orchestration
- Xians UI - Web-based management interface
- Temporal - Workflow orchestration engine
- Keycloak - Authentication and authorization
- Database Components - Data persistence layer
Installation Steps¶
For detailed setup instructions, configuration options, and troubleshooting, visit:
📚 XiansAi Platform - Community Edition
Next Steps¶
Once your platform is running locally, proceed to the Quick Start guide to create your first agent.
Getting Help¶
If you encounter any issues: