RepoPicks Radar

Updated every day around 23:30 UTC

Guides

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

10,04010,05010,06010,07010,08010,090 Nov 5Nov 6Nov 7Nov 8Nov 9Nov 10 10,04010,05010,06010,07010,08010,090 Nov 5Nov 8

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)
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.

Similar projects

The RepoPicks app

Coming soon: install in 1 click with the RepoPicks app.

Before you download

See the release page on GitHub