Agent execution, session orchestration, and knowledge search service for the Evo CRM Community.
Website · Documentation · Community · Support
Evo CRM Agent Processor is the AI execution core of the Evo CRM Community. It orchestrates intelligent workflows between multiple agents, manages sessions and artifacts, executes Google ADK agents, and integrates with vector databases for semantic knowledge search.
Built with FastAPI, it provides:
- Workflow orchestration between agents using LangGraph
- Execution of Google ADK agents and integration with Google GenAI
- Session, event, and artifact processing
- Knowledge search and storage in vector databases (Pinecone, Qdrant, OpenSearch)
- JWT authentication for protected endpoints
- Redis caching for performance
- OpenAI and provider-neutral integrations for embeddings
- RESTful API with FastAPI
- Observability via OpenTelemetry
Evo CRM Agent Processor is part of the Evo CRM Community ecosystem maintained by Evolution Foundation. To use the full stack, clone the umbrella repository with submodules:
git clone --recurse-submodules git@github.com:evolution-foundation/evo-crm-community.gitThe Community Edition is single-tenant by design — one account, no multi-tenancy overhead, no super-admin, no billing or plans. All limits are removed and features are unlocked by default.
| Component | Technology |
|---|---|
| Web framework | FastAPI |
| ORM | SQLAlchemy |
| Database | PostgreSQL 13+ |
| Cache | Redis 6+ |
| ASGI server | Uvicorn |
| Authentication | JWT (python-jose, pyjwt) |
| Vector databases | Pinecone, Qdrant, OpenSearch |
| Agents | Google ADK, LangGraph |
| Artifact storage | MinIO |
| Observability | OpenTelemetry |
| Migrations | Alembic |
- Python 3.10+
- PostgreSQL 13.0+
- Redis 6.0+
- uv package manager:
curl -LsSf https://astral.sh/uv/install.sh | sh - Make
git clone git@github.com:evolution-foundation/evo-ai-processor-community.git
cd evo-ai-processor-community
# Create virtual environment and install dependencies
make venv
source venv/bin/activate # Linux/Mac
make install-dev
# Configure environment
cp .env.example .env
# Edit .env with your settingsmake run # Development with hot reload
make run-prod # ProductionThe API will be available at http://localhost:8000.
make docker-build
make docker-up
make docker-seed# Code quality
make lint # Verify with flake8
make format # Format with black
# Cache management
make clear-python-cache # Remove .pyc and __pycache__
make clear-uv-cache # Clean UV cache
make clear-all-cache # Comprehensive cleanup
# Environment
make reset-venv # Recreate virtual environment
make refresh-env # Reset and reinstall dependenciesThe processor sits between the bot runtime and the agent execution layer:
Evo Bot Runtime
↓
Evo CRM Agent Processor ← (you are here)
↓
Google ADK / LangGraph + Vector DBs (Pinecone/Qdrant/OpenSearch)
↓
Evo CRM Backend (persistence)
Key responsibilities:
- Session management: per-conversation agent state
- Artifact storage: stores intermediate results in MinIO
- Vector search: semantic retrieval over knowledge bases
- Workflow orchestration: LangGraph-based multi-agent flows
- Event processing: emits events for downstream services
| Resource | Link |
|---|---|
| Website | evolutionfoundation.com.br |
| Documentation | docs.evolutionfoundation.com.br |
| Community | evolutionfoundation.com.br/community |
| Changelog | CHANGELOG.md |
| Contributing | CONTRIBUTING.md |
| Security | SECURITY.md |
Contributions are welcome! Please read CONTRIBUTING.md for guidelines on how to submit issues, propose features, and open pull requests.
Join our community to discuss ideas and collaborate.
For security issues, do not open a public issue. Email suporte@evofoundation.com.br or use GitHub's private vulnerability reporting. See SECURITY.md for details.
This service builds on excellent open-source software:
- FastAPI — web framework
- LangGraph — agent workflow orchestration
- Google ADK — agent execution
- Pinecone, Qdrant, OpenSearch — vector databases
- Alembic — database migrations
Evo CRM Agent Processor is licensed under the Apache License 2.0. See LICENSE for details.
"Evolution Foundation", "Evolution" and "Evo CRM Agent Processor" are trademarks of Evolution Foundation. See TRADEMARKS.md for the brand assets policy.
Third-party attributions are documented in NOTICE.
Made by Evolution Foundation · © 2026