Open-source, single-tenant AI-powered customer support platform.

Website · Documentation · Community · Support the project

EVO CRM Community is the open-source edition of the EVO CRM platform — a complete suite for AI-assisted customer support. It brings together authentication, CRM, AI agents, agent processing and a modern frontend into a unified, self-hostable stack.

This repository is the monorepo entrypoint: it aggregates all community services as Git submodules, giving you a single place to clone, update and orchestrate the entire platform.

The platform is composed of 6 independent services:

• Single-tenant — one account, no multi-tenancy overhead
• No super-admin — all configuration via seed data and environment variables
• No billing / plans — all limits removed, features unlocked by default
• Role hierarchy: account_owner and agent — no intermediate roles
• Account resolution via token — no account-id header required between services

• Docker & Docker Compose
• Git with submodule support

git clone --recurse-submodules [email protected]:EvolutionAPI/evo-crm-community.git
cd evo-crm-community

If you already cloned without submodules:

git submodule update --init --recursive

git submodule update --remote --merge

Refer to each service's own README for environment configuration, setup and seed instructions:

• evo-auth-service-community
• evo-ai-crm-community
• evo-ai-frontend-community
• evo-ai-processor-community
• evo-ai-core-service-community
• evo-bot-runtime

Note: evo-auth-service-community must be seeded before evo-ai-crm-community — the CRM depends on the user created by the auth seed.

For detailed setup instructions, visit the full documentation.

evo-ai-frontend-community
    └── evo-auth-service-community  (authentication)
    └── evo-ai-crm-community        (conversations, contacts)
    └── evo-ai-core-service-community (agents, tools, API keys)
    └── evo-ai-processor-community  (agent execution, sessions)
        └── evo-bot-runtime         (bot pipeline execution)

All inter-service communication uses Bearer token authentication. The token issued by evo-auth-service-community is forwarded between services — no additional headers required.

Contributions are welcome! Please open an issue or pull request in the relevant submodule repository.

Join the community to discuss ideas, ask questions and collaborate.

Want to support the project? Visit evolutionfoundation.com.br/contribute.

Apache 2.0 — see LICENSE for details.

Made with love by Evolution Foundation.