Evolution API
evolution-foundation/evolution-apiReviewed by AI
Checked by RepoPicks Radar on
What is Evolution API?
Evolution API is a server that sits between WhatsApp and your other tools. You connect a WhatsApp number (by QR code through the unofficial Baileys route, or with Meta's official Cloud API) and then send and receive messages over a REST API, with ready connections to Typebot, Chatwoot, n8n, Dify, OpenAI, RabbitMQ, Kafka and S3. It is made for developers and agencies: you need a server with Node.js 20+, PostgreSQL or MySQL and ideally Redis, or the Docker Compose files in the repository.
Evolution API is free and open source (Apache-2.0) and can replace ManyChat, Twilio WhatsApp API, and Chatfuel.
How easy is it to install Evolution API?
D · terminal, several tools or a specific graphics card · Windows
- Windows D
- macOS D
- Linux D
Linux on a server is the usual home and is still a D: no installer, you clone the repository, fill in a long .env file, provide PostgreSQL or MySQL and Redis, run database migrations and start it with Docker Compose or Node.js. Mac and Windows run the same stack from the terminal (package.json even has separate Windows migration scripts), so they are no easier.
Coming soon: install in 1 click with the RepoPicks app.
Evolution API on GitHub
- Stars
- 10,083on Nov 10, 2026
- Downloads
- —all releases
- Growth
- +49stars in 6 days
Stars over time
Facts
- Runs on
- Windows, macOS, Linux
- You need to install
- Node.js, Docker, FFmpeg
- To build from source
- Node.js, Docker, FFmpeg
- Disk space
- 100 MB–500 MB · estimate
- Accounts or keys
- Meta WhatsApp Cloud API (only for the official route), OpenAI (optional, for voice-to-text and AI replies), Pusher (optional, for events)
- Cost
- Free · The code is free, but the LICENSE adds conditions: keeping the logo and showing a notice that Evolution API is in use, or buying a commercial licence. Meta's official Cloud API route charges per message, and the OpenAI and Pusher connections are paid services.
- License
- Apache-2.0 (Permissive)
- Can replace
- ManyChat, WhatsApp API, Chatfuel
- Last change on GitHub
- May 6, 2026
Evolution API risk signals (7)
- AttentionDependencies with known vulnerabilities
Pinned dependencies with known vulnerabilities (OSV): baileys: GHSA-qvv5-jq5g-4cgg
automatic check
- Attentionunofficial whatsapp access risks the number
README: "WhatsApp API - Baileys: A free API based on WhatsApp Web, leveraging the Baileys library... this method relies on the web version of WhatsApp and may have limitations compared to official APIs". This route is not authorised by Meta: automating a normal account this way goes against WhatsApp's terms and the number can be blocked. Bulk sending can also break local marketing and consumer-protection rules.
AI review
- Attentionlicense adds conditions beyond apache
GitHub reports the licence as NOASSERTION and the LICENSE file explains why: "Apache License 2.0, with the following additional conditions... you may not remove or modify the LOGO or copyright information" and "the user is required to display a clear notification within the system that Evolution API is being utilized. Failure to comply with this requirement may result in the necessity for a commercial license".
AI review
- Attentionstores other peoples messages and contacts
.env.example turns on saving everything by default: DATABASE_SAVE_DATA_NEW_MESSAGE=true, DATABASE_SAVE_DATA_CONTACTS=true, DATABASE_SAVE_DATA_CHATS=true, DATABASE_SAVE_DATA_HISTORIC=true. Your database ends up holding your customers' conversations and phone numbers, which brings privacy duties (LGPD, GDPR) onto you.
AI review
- Attentiontelemetry on by default
.env.example ships TELEMETRY_ENABLED=true and the README says it "collects anonymous telemetry data (routes used, most accessed routes, API version)". It phones home unless you set it to false yourself.
AI review
- Infoopen by default settings
.env.example sets CORS_ORIGIN=* (any website may call the API from a browser), and docker-compose.dev.yaml publishes port 8080 on every network interface while docker-compose.yaml binds it to 127.0.0.1. There is no HTTPS in front of it unless you add one.
AI review
- Infodevelopment slowed and newest builds are previews
The checks record the last commit on 2026-05-06 (182 days before this analysis) and the last release on 2026-05-17. The two newest releases are 2.4.0-rc2 and 2.4.0-rc1, marked as release candidates; the last stable one is 2.3.7 from 2025-12-05.
AI review
Evidence is shown in its original language.
What Radar could not check about Evolution API
- Whether the unofficial WhatsApp Web route still works today, since Meta changes it and the library has to follow.
- How likely a number is to be blocked in real use.
- Whether the published Docker image matches the code in this repository.
- How much the Meta Cloud API and the OpenAI connections cost for your message volume.
- Whether the flagged vulnerable version of the baileys library affects your setup in practice.