{"id":49957419,"url":"https://github.com/evolution-foundation/evo-crm-community","last_synced_at":"2026-05-28T00:01:35.140Z","repository":{"id":351854715,"uuid":"1185376972","full_name":"evolution-foundation/evo-crm-community","owner":"evolution-foundation","description":"Open source and self-hosted AI-powered customer service platform. Single-tenant, no multi-account, no per-user charges — you run the complete stack on your server.","archived":false,"fork":false,"pushed_at":"2026-05-25T17:04:26.000Z","size":838,"stargazers_count":148,"open_issues_count":60,"forks_count":115,"subscribers_count":6,"default_branch":"main","last_synced_at":"2026-05-25T17:26:24.264Z","etag":null,"topics":["ai","ai-agents","bot","campaign","chatwoot","crm","pipeline","whatsapp"],"latest_commit_sha":null,"homepage":"https://evolutionfoundation.com.br","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/evolution-foundation.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-18T14:19:08.000Z","updated_at":"2026-05-25T16:24:27.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/evolution-foundation/evo-crm-community","commit_stats":null,"previous_names":["evolutionapi/evo-crm-community","evolution-foundation/evo-crm-community"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/evolution-foundation/evo-crm-community","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evolution-foundation%2Fevo-crm-community","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evolution-foundation%2Fevo-crm-community/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evolution-foundation%2Fevo-crm-community/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evolution-foundation%2Fevo-crm-community/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/evolution-foundation","download_url":"https://codeload.github.com/evolution-foundation/evo-crm-community/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evolution-foundation%2Fevo-crm-community/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33588345,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-27T02:00:06.184Z","response_time":53,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","ai-agents","bot","campaign","chatwoot","crm","pipeline","whatsapp"],"created_at":"2026-05-18T00:18:50.535Z","updated_at":"2026-05-28T00:01:35.131Z","avatar_url":"https://github.com/evolution-foundation.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://evolutionfoundation.com.br\"\u003e\n    \u003cimg src=\"./public/hover-evolution.png\" alt=\"Evolution Foundation\" /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eEvo CRM Community\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  Open-source, single-tenant AI-powered customer support platform — by Evolution Foundation.\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/evolution-foundation/evo-crm-community/releases/latest\"\u003e\u003cimg src=\"https://img.shields.io/github/v/release/evolution-foundation/evo-crm-community?include_prereleases\u0026label=version\u0026color=00ffa7\" alt=\"Latest version\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://opensource.org/licenses/Apache-2.0\"\u003e\u003cimg src=\"https://img.shields.io/badge/License-Apache%202.0-blue.svg\" alt=\"License: Apache 2.0\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://docs.evolutionfoundation.com.br\"\u003e\u003cimg src=\"https://img.shields.io/badge/Docs-evolutionfoundation.com.br-00ffa7\" alt=\"Documentation\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://evolutionfoundation.com.br/community\"\u003e\u003cimg src=\"https://img.shields.io/badge/Community-Join%20us-white\" alt=\"Community\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://evolutionfoundation.com.br\"\u003eWebsite\u003c/a\u003e \u0026middot;\n  \u003ca href=\"https://docs.evolutionfoundation.com.br\"\u003eDocumentation\u003c/a\u003e \u0026middot;\n  \u003ca href=\"https://evolutionfoundation.com.br/community\"\u003eCommunity\u003c/a\u003e \u0026middot;\n  \u003ca href=\"mailto:suporte@evofoundation.com.br\"\u003eSupport\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n## About\n\n**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, bot pipelines and a modern frontend into a unified, self-hostable stack.\n\nThis 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.\n\n---\n\n## Current Version\n\n**`v1.0.0-rc2`** (latest) — see the [release notes](https://github.com/evolution-foundation/evo-crm-community/releases/tag/v1.0.0-rc2) for highlights, security advisories and known issues. Previous: [`v1.0.0-rc1`](https://github.com/evolution-foundation/evo-crm-community/releases/tag/v1.0.0-rc1).\n\nThe umbrella tag pins each Community submodule at its corresponding `v1.0.0-rc2` tag. Cloning with `--recurse-submodules` at this tag reproduces the full stack as released:\n\n| Service | Git tag | Docker image | Release notes |\n|---|---|---|---|\n| [`evo-auth-service-community`](https://github.com/evolution-foundation/evo-auth-service-community) | `v1.0.0-rc2` | `evoapicloud/evo-auth-service-community:1.0.0-rc2` | [link](https://github.com/evolution-foundation/evo-auth-service-community/releases/tag/v1.0.0-rc2) |\n| [`evo-ai-crm-community`](https://github.com/evolution-foundation/evo-ai-crm-community) | `v1.0.0-rc2` | `evoapicloud/evo-ai-crm-community:1.0.0-rc2` | [link](https://github.com/evolution-foundation/evo-ai-crm-community/releases/tag/v1.0.0-rc2) |\n| [`evo-ai-frontend-community`](https://github.com/evolution-foundation/evo-ai-frontend-community) | `v1.0.0-rc2` | `evoapicloud/evo-ai-frontend-community:1.0.0-rc2` | [link](https://github.com/evolution-foundation/evo-ai-frontend-community/releases/tag/v1.0.0-rc2) |\n| [`evo-ai-processor-community`](https://github.com/evolution-foundation/evo-ai-processor-community) | `v1.0.0-rc2` | `evoapicloud/evo-ai-processor-community:1.0.0-rc2` | [link](https://github.com/evolution-foundation/evo-ai-processor-community/releases/tag/v1.0.0-rc2) |\n| [`evo-ai-core-service-community`](https://github.com/evolution-foundation/evo-ai-core-service-community) | `v1.0.0-rc2` | `evoapicloud/evo-ai-core-service-community:1.0.0-rc2` | [link](https://github.com/evolution-foundation/evo-ai-core-service-community/releases/tag/v1.0.0-rc2) |\n| [`evo-bot-runtime`](https://github.com/evolution-foundation/evo-bot-runtime) | `v1.0.0-rc2` | `evoapicloud/evo-bot-runtime:1.0.0-rc2` | [link](https://github.com/evolution-foundation/evo-bot-runtime/releases/tag/v1.0.0-rc2) |\n| `evo-crm-gateway` (built from this repo) | `v1.0.0-rc2` | `evoapicloud/evo-crm-gateway:1.0.0-rc2` | (see umbrella release) |\n\nThe following projects are **part of the broader Evolution Foundation ecosystem** but follow independent versioning:\n\n| Service | Repository | Notes |\n|---|---|---|\n| [`evolution-api`](https://github.com/evolution-foundation/evolution-api) | WhatsApp messaging API (Node.js) | Independent versioning |\n| [`evolution-go`](https://github.com/evolution-foundation/evolution-go) | WhatsApp messaging API (Go) | Independent versioning |\n| [`evo-nexus`](https://github.com/evolution-foundation/evo-nexus) | Multi-agent operating layer | Independent versioning |\n\n\u003e **Note on tag naming**: the **git tag** has the `v` prefix (`v1.0.0-rc2`) following standard Git convention. The **Docker tag** drops the `v` (`1.0.0-rc2`) following SemVer / Docker Hub convention. `latest` on Docker Hub always tracks the most recent published tag.\n\n```bash\n# Source clone (pinned to the release):\ngit clone --recurse-submodules --branch v1.0.0-rc2 git@github.com:evolution-foundation/evo-crm-community.git\n\n# Or pull pre-built images (compose files use :latest by default):\ndocker pull evoapicloud/evo-ai-crm-community:1.0.0-rc2\n```\n\n---\n\n## Architecture\n\nThe Evo CRM Community platform is composed of 6 independent services:\n\n| Service | Role | Stack | Default Port |\n|---|---|---|---|\n| [`evo-auth-service-community`](./evo-auth-service-community) | Authentication, RBAC, OAuth 2.0, token issuance | Ruby 3.4 / Rails 7.1 | `3001` |\n| [`evo-ai-crm-community`](./evo-ai-crm-community) | Conversations, contacts, inboxes, messaging | Ruby 3.4 / Rails 7.1 | `3000` |\n| [`evo-ai-frontend-community`](./evo-ai-frontend-community) | Web interface | React / TypeScript / Vite | `5173` |\n| [`evo-ai-processor-community`](./evo-ai-processor-community) | AI agent execution, sessions, tools, MCP | Python 3.10 / FastAPI | `8000` |\n| [`evo-ai-core-service-community`](./evo-ai-core-service-community) | Agent management, API keys, folders | Go / Gin | `5555` |\n| [`evo-bot-runtime`](./evo-bot-runtime) | Bot pipeline execution, debouncing, dispatch | Go / Gin | `8080` |\n\n### Design principles (Community Edition)\n\n- **Single-tenant** — one account, no multi-tenancy overhead\n- **No super-admin** — all configuration via seed data and environment variables\n- **No billing / plans** — all limits removed, features unlocked by default\n- **Role hierarchy**: `account_owner` and `agent` — no intermediate roles\n- **Account resolution** via token — no `account-id` header required between services\n\n### Companion services (independent versioning)\n\nThe following services are part of the Evolution Foundation ecosystem but are not pinned to the Evo CRM release tag:\n\n| Service | Role |\n|---|---|\n| [`evolution-api`](./evolution-api) | WhatsApp messaging engine (Node.js) — used as a channel provider |\n| [`evolution-go`](./evolution-go) | WhatsApp messaging engine (Go) — alternative high-performance provider |\n| [`evo-nexus`](./evo-nexus) | Multi-agent operating layer — used internally by Evolution Foundation to coordinate development and operations |\n\n---\n\n## Getting Started\n\n### Prerequisites\n\n- Docker \u0026 Docker Compose\n- Git with submodule support\n\n### 1. Clone with submodules\n\n```bash\ngit clone --recurse-submodules git@github.com:evolution-foundation/evo-crm-community.git\ncd evo-crm-community\n```\n\nIf you already cloned without submodules:\n\n```bash\ngit submodule update --init --recursive\n```\n\n### 2. Update all submodules to latest\n\n```bash\ngit submodule update --remote --merge\n```\n\n### 3. Setup each service\n\nRefer to each service's own README for environment configuration, setup and seed instructions:\n\n- [evo-auth-service-community](https://github.com/evolution-foundation/evo-auth-service-community#readme)\n- [evo-ai-crm-community](https://github.com/evolution-foundation/evo-ai-crm-community#readme)\n- [evo-ai-frontend-community](https://github.com/evolution-foundation/evo-ai-frontend-community#readme)\n- [evo-ai-processor-community](https://github.com/evolution-foundation/evo-ai-processor-community#readme)\n- [evo-ai-core-service-community](https://github.com/evolution-foundation/evo-ai-core-service-community#readme)\n- [evo-bot-runtime](https://github.com/evolution-foundation/evo-bot-runtime#readme)\n\n\u003e **Note:** `evo-auth-service-community` must be seeded before `evo-ai-crm-community` — the CRM depends on the user created by the auth seed.\n\n\u003e **Production deployment — required environment overrides**\n\u003e\n\u003e Before promoting any environment to production, the following variables in `.env.example` must be replaced with public URLs (the bundled `http://localhost:*` defaults exist for local development only):\n\u003e\n\u003e - **`BACKEND_URL`** — public URL of the CRM backend (e.g. `https://crm.example.com`). The CRM refuses to boot in production if this is missing or points at localhost.\n\u003e - **`FRONTEND_URL`** — public URL of the frontend (e.g. `https://app.example.com`). Used for OAuth redirects and channel webhook fallbacks.\n\u003e\n\u003e Leaving the localhost defaults in production results in webhook callbacks pointing at the container, broken OAuth redirects and silently failed external integrations.\n\nFor detailed setup instructions, visit the [full documentation](https://docs.evolutionfoundation.com.br).\n\n---\n\n## Service Dependencies\n\n```\nevo-ai-frontend-community\n    └── evo-auth-service-community  (authentication)\n    └── evo-ai-crm-community        (conversations, contacts)\n    └── evo-ai-core-service-community (agents, tools, API keys)\n    └── evo-ai-processor-community  (agent execution, sessions)\n        └── evo-bot-runtime         (bot pipeline execution)\n```\n\nAll inter-service communication uses Bearer token authentication. The token issued by `evo-auth-service-community` is forwarded between services — no additional headers required.\n\n---\n\n## Submodules Reference\n\n### Evo CRM Community core (pinned to `v1.0.0-rc2`)\n\n| Submodule | Repository |\n|---|---|\n| `evo-auth-service-community` | [evolution-foundation/evo-auth-service-community](https://github.com/evolution-foundation/evo-auth-service-community) |\n| `evo-ai-crm-community` | [evolution-foundation/evo-ai-crm-community](https://github.com/evolution-foundation/evo-ai-crm-community) |\n| `evo-ai-frontend-community` | [evolution-foundation/evo-ai-frontend-community](https://github.com/evolution-foundation/evo-ai-frontend-community) |\n| `evo-ai-processor-community` | [evolution-foundation/evo-ai-processor-community](https://github.com/evolution-foundation/evo-ai-processor-community) |\n| `evo-ai-core-service-community` | [evolution-foundation/evo-ai-core-service-community](https://github.com/evolution-foundation/evo-ai-core-service-community) |\n| `evo-bot-runtime` | [evolution-foundation/evo-bot-runtime](https://github.com/evolution-foundation/evo-bot-runtime) |\n\n### Companion projects (independent versioning)\n\n| Submodule | Repository |\n|---|---|\n| `evolution-api` | [evolution-foundation/evolution-api](https://github.com/evolution-foundation/evolution-api) |\n| `evolution-go` | [evolution-foundation/evolution-go](https://github.com/evolution-foundation/evolution-go) |\n| `evo-nexus` | [evolution-foundation/evo-nexus](https://github.com/evolution-foundation/evo-nexus) |\n\n---\n\n## Documentation\n\n| Resource | Link |\n|---|---|\n| Website | [evolutionfoundation.com.br](https://evolutionfoundation.com.br) |\n| Documentation | [docs.evolutionfoundation.com.br](https://docs.evolutionfoundation.com.br) |\n| Community | [evolutionfoundation.com.br/community](https://evolutionfoundation.com.br/community) |\n| Changelog | [CHANGELOG.md](./CHANGELOG.md) |\n| Contributing | [CONTRIBUTING.md](./CONTRIBUTING.md) |\n| Security | [SECURITY.md](./SECURITY.md) |\n\n---\n\n## Hosting\n\nDeploy Evo CRM Community with optimized infrastructure through our HostGator partnership:\n\n[**Evo CRM VPS — HostGator**](https://evolution-api.com/vps-evo-crm)\n\n---\n\n## Contributing\n\nContributions are welcome! Please open an issue or pull request in the relevant submodule repository. See [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.\n\nJoin our [community](https://evolutionfoundation.com.br/community) to discuss ideas, ask questions and collaborate.\n\n---\n\n## Security\n\nFor security issues, **do not open a public issue**. Email **suporte@evofoundation.com.br** or use GitHub's private vulnerability reporting. See [SECURITY.md](./SECURITY.md) for details.\n\n---\n\n## License\n\nEvo CRM Community is licensed under the Apache License 2.0, with additional brand-protection conditions (LOGO/copyright preservation and Usage Notification requirement). See [LICENSE](./LICENSE) for full details.\n\nFor licensing inquiries, contact **suporte@evofoundation.com.br**.\n\n## Trademarks\n\n\"Evolution Foundation\", \"Evolution\" and \"Evo CRM\" are trademarks of Evolution Foundation. See [TRADEMARKS.md](./TRADEMARKS.md) for the brand assets policy.\n\nThird-party attributions are documented in [NOTICE](./NOTICE).\n\n---\n\n\u003cp align=\"center\"\u003e\n  Made by \u003ca href=\"https://evolutionfoundation.com.br\"\u003eEvolution Foundation\u003c/a\u003e · © 2026\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fevolution-foundation%2Fevo-crm-community","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fevolution-foundation%2Fevo-crm-community","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fevolution-foundation%2Fevo-crm-community/lists"}