Installation

Set up EthixAI locally using Docker Compose or manual installation.

Docker Compose (Recommended)

Easiest

The fastest way to get EthixAI running with all services configured.

Prerequisites

Docker Desktop (or Docker Engine + Docker Compose)
4GB RAM minimum (8GB recommended)
10GB free disk space

1. Clone the repository

git clone https://github.com/ethixai/ethixai.git cd ethixai

2. Configure environment variables

cp .env.example .env # Edit .env with your Firebase credentials

3. Start all services

docker-compose up -d

4. Access the application

Frontend: http://localhost:3000
Backend API: http://localhost:8000
AI Core: http://localhost:8001
Prometheus: http://localhost:9090
Grafana: http://localhost:3001

Manual Installation

For development or custom deployments, install components individually.

Frontend

cd frontend npm install npm run dev

Runs on port 3000

Backend

cd backend python -m venv venv source venv/bin/activate  # Windows: venv\Scripts\activate pip install -r requirements.txt uvicorn main:app --reload --port 8000

Runs on port 8000

AI Core

cd ai_core python -m venv venv source venv/bin/activate pip install -r requirements.txt uvicorn main:app --reload --port 8001

Runs on port 8001

Verification

Test your installation with these health checks:

# Backend health check curl http://localhost:8000/health # AI Core health check curl http://localhost:8001/health # Expected response:{"status": "healthy", "version": "1.0.0"}