Self-host Evo AI

Evo AI README

How to install Evo AI

NEXT_PUBLIC_API_URL

# From frontend directory
cd frontend

# Build frontend image
docker build -t evo-ai-frontend .

# Run frontend container
docker run -p 3000:3000 -e NEXT_PUBLIC_API_URL=http://localhost:8000 evo-ai-frontend

POSTGRES_PASSWORD, REDIS_PORT, REDIS_PASSWORD, JWT_SECRET_KEY, SENDGRID_API_KEY, EMAIL_FROM, APP_URL, LOG_LEVEL, DEBUG

# Build and start all services (backend + database + redis)
make docker-build
make docker-up

# Initialize database with seed data
make docker-seed

POSTGRES_CONNECTION_STRING, REDIS_HOST, REDIS_PORT, JWT_SECRET_KEY, ENCRYPTION_KEY, AI_ENGINE, EMAIL_PROVIDER

git clone https://github.com/EvolutionAPI/evo-ai.git
cd evo-ai

# Create and activate virtual environment
make venv
source venv/bin/activate  # Linux/Mac
# or on Windows: venv\Scripts\activate

# Install development dependencies
make install-dev

# Copy and configure backend environment
cp .env.example .env
# Edit the .env file with your database, Redis, and other settings

# Initialize database and apply migrations
make alembic-upgrade

# Seed initial data (admin user, sample clients, etc.)
make seed-all

How to configure Evo AI

• ADMIN_EMAIL=admin@evoai.comSeeder settings

  Seeder settings

• ADMIN_INITIAL_PASSWORD
• AI_ENGINE=adkAI Engine configuration: "adk" or "crewai"

  AI Engine configuration: "adk" or "crewai"

• API_DESCRIPTION=API para execução de agentes de IA
• API_TITLE=Evo API
• API_URL=http://localhost:8000
• API_VERSION=1.0.0
• APP_URLPublic URL of the application (used in emails/links).

  Public URL of the application (used in emails/links).

• DEBUG=false
• DEMO_CLIENT_NAME=Demo Client
• DEMO_EMAIL
• DEMO_PASSWORD
• EMAIL_FROMSender address for notification emails.

  Sender address for notification emails.

• EMAIL_PROVIDER=sendgridEmail provider settings

  Email provider settings

• ENCRYPTION_KEYKey used to encrypt stored API keys.

  Key used to encrypt stored API keys.

• HOST=0.0.0.0Server settings

  Server settings

• JWT_ALGORITHM=HS256
• JWT_EXPIRATION_TIME=3600In seconds

  In seconds

• JWT_SECRET_KEYSecret key used to sign JWT auth tokens.

  Secret key used to sign JWT auth tokens.

• LANGFUSE_PUBLIC_KEYPublic key of the Langfuse project for tracing.

  Public key of the Langfuse project for tracing.

• LANGFUSE_SECRET_KEYSecret key of the Langfuse project for tracing.

  Secret key of the Langfuse project for tracing.

• LOG_DIR=logs
• LOG_LEVEL=INFOLogging settings

  Logging settings

• NEXT_PUBLIC_API_URL=http://localhost:8000Backend API URL the Next.js frontend calls.

  Backend API URL the Next.js frontend calls.

• ORGANIZATION_NAME=Evo AI
• ORGANIZATION_URL=https://evoai.evoapicloud.com
• OTEL_EXPORTER_OTLP_ENDPOINT=https://cloud.langfuse.com/api/public/otel
• PORT=8000
• POSTGRES_CONNECTION_STRINGPostgreSQL connection string used by the backend (SQLAlchemy/Alembic).

  PostgreSQL connection string used by the backend (SQLAlchemy/Alembic).

• REDIS_DB=0
• REDIS_HOST=localhostRedis settings

  Redis settings

• REDIS_KEY_PREFIX
• REDIS_PASSWORDPassword for the Redis server.

  Password for the Redis server.

• REDIS_PORT=6379
• REDIS_SSL=false
• REDIS_TTL=3600
• SENDGRID_API_KEYAPI key for the SendGrid email provider.

  API key for the SendGrid email provider.

• SMTP_FROMSender address used for SMTP mail.

  Sender address used for SMTP mail.

• SMTP_HOSTSMTP server host when the SMTP email provider is selected.

  SMTP server host when the SMTP email provider is selected.

• SMTP_PASSWORDSMTP login password.

  SMTP login password.

• SMTP_PORT=587
• SMTP_USERSMTP login username.

  SMTP login username.

• SMTP_USE_SSL=false
• SMTP_USE_TLS=true
• TOOLS_CACHE_TTL=3600Tools cache TTL in seconds (1 hour)

  Tools cache TTL in seconds (1 hour)