[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-93876":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":9,"totalLinesOfCode":9,"stars":12,"forks":13,"watchers":14,"openIssues":14,"contributorsCount":9,"subscribersCount":14,"size":14,"stars1d":14,"stars7d":14,"stars30d":14,"stars90d":14,"forks30d":14,"starsTrendScore":14,"compositeScore":15,"rankGlobal":9,"rankLanguage":9,"license":9,"archived":16,"fork":16,"defaultBranch":17,"hasWiki":16,"hasPages":16,"topics":9,"createdAt":9,"pushedAt":9,"updatedAt":18,"readmeContent":19,"aiSummary":20,"trendingCount":14,"starSnapshotCount":14,"syncStatus":21,"lastSyncTime":9,"discoverSource":22},93876,"evolution-go","evolution-foundation\u002Fevolution-go","evolution-foundation","Evolution API \u002F Evolution Go is an open-source WhatsApp integration API",null,"https:\u002F\u002Fgithub.com\u002Fevolution-foundation\u002Fevolution-go","Go",523,290,0,48.39,false,"main","2026-09-21 04:01:26","\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fevolutionfoundation.com.br\">\n    \u003Cimg src=\".\u002Fpublic\u002Fhover-evolution.png\" alt=\"Evolution Foundation\" \u002F>\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Ch1 align=\"center\">Evolution Go\u003C\u002Fh1>\n\n\u003Cp align=\"center\">\n  High-performance WhatsApp API built in Go — part of the Evolution Foundation ecosystem.\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fevolution-foundation\u002Fevolution-go\u002Freleases\u002Flatest\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fv\u002Frelease\u002Fevolution-foundation\u002Fevolution-go?include_prereleases&label=version&color=00ffa7\" alt=\"Latest version\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fopensource.org\u002Flicenses\u002FApache-2.0\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-Apache%202.0-blue.svg\" alt=\"License: Apache 2.0\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fdocs.evolutionfoundation.com.br\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDocs-evolutionfoundation.com.br-00ffa7\" alt=\"Documentation\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fevolutionfoundation.com.br\u002Fcommunity\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FCommunity-Join%20us-white\" alt=\"Community\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fhub.docker.com\u002Fr\u002Fevoapicloud\u002Fevolution-go\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDocker-evoapicloud-blue\" alt=\"Docker image\" \u002F>\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fevolutionfoundation.com.br\">Website\u003C\u002Fa> ·\n  \u003Ca href=\"https:\u002F\u002Fdocs.evolutionfoundation.com.br\">Documentation\u003C\u002Fa> ·\n  \u003Ca href=\"https:\u002F\u002Fevolutionfoundation.com.br\u002Fcommunity\">Community\u003C\u002Fa> ·\n  \u003Ca href=\"mailto:suporte@evofoundation.com.br\">Support\u003C\u002Fa>\n\u003C\u002Fp>\n\n\n---\n\n## About\n\n**Evolution Go** is a high-performance WhatsApp API built in Go. Part of the Evolution Foundation ecosystem, it provides a robust, lightweight solution for WhatsApp integration using the [whatsmeow](https:\u002F\u002Fgithub.com\u002Ftulir\u002Fwhatsmeow) library.\n\n## Part of the Evolution Foundation ecosystem\n\nEvolution Go is one of the messaging engines maintained by Evolution Foundation. It is used as a WhatsApp provider by the [Evo CRM Community](https:\u002F\u002Fgithub.com\u002Fevolution-foundation\u002Fevo-crm-community) and other projects in the ecosystem.\n\n---\n\n## Features\n\n- **High performance** — built with Go for minimal resource usage\n- **RESTful API** — clean, well-documented REST endpoints with Swagger\n- **Real-time events** — WebSocket, Webhook, AMQP\u002FRabbitMQ and NATS support\n- **Media support** — images, videos, audio, documents with MinIO\u002FS3 storage\n- **Message storage** — optional PostgreSQL persistence\n- **QR code pairing** — built-in QR code generation for device linking\n- **License management** — built-in licensing with registration, activation, and heartbeat\n- **Docker ready** — production-ready Docker configuration\n\n---\n\n## Quick Start\n\n### Docker (recommended)\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fevolution-foundation\u002Fevolution-go.git\ncd evolution-go\nmake docker-build\nmake docker-run\n```\n\n### Local development\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fevolution-foundation\u002Fevolution-go.git\ncd evolution-go\n\n# Setup, configure and run\nmake setup\ncp .env.example .env\nmake dev\n```\n\n> Run `make help` to see all available commands. See [COMMANDS.md](.\u002FCOMMANDS.md) for detailed workflows.\n\n---\n\n## Configuration\n\nCreate a `.env` file:\n\n```env\n# Server\nSERVER_PORT=8080\nCLIENT_NAME=evolution\n\n# Security\nGLOBAL_API_KEY=your-secure-api-key-here\n\n# Database\nPOSTGRES_AUTH_DB=postgresql:\u002F\u002Fpostgres:password@localhost:5432\u002Fevogo_auth?sslmode=disable\nPOSTGRES_USERS_DB=postgresql:\u002F\u002Fpostgres:password@localhost:5432\u002Fevogo_users?sslmode=disable\nDATABASE_SAVE_MESSAGES=false\n\n# Logging\nWADEBUG=DEBUG\nLOGTYPE=console\n\n# Optional\n# AMQP_URL=amqp:\u002F\u002Fguest:guest@localhost:5672\u002F\n# NATS_URL=nats:\u002F\u002Flocalhost:4222\n# WEBHOOK_URL=https:\u002F\u002Fyour-webhook-url.com\u002Fwebhook\n# MINIO_ENABLED=true\n# MINIO_ENDPOINT=localhost:9000\n# MINIO_ACCESS_KEY=minioadmin\n# MINIO_SECRET_KEY=minioadmin\n```\n\n| Variable | Description | Default |\n|---|---|---|\n| `SERVER_PORT` | Server port | `8080` |\n| `CLIENT_NAME` | Client identifier | `evolution` |\n| `GLOBAL_API_KEY` | API authentication key | **Required** |\n| `DATABASE_SAVE_MESSAGES` | Enable message storage | `false` |\n| `WADEBUG` | WhatsApp debug level | `INFO` |\n\n---\n\n## License Activation\n\nEvolution Go requires a license to operate. On first run:\n\n1. Start the server — API endpoints return `503` until activated\n2. Open the **Manager** at `http:\u002F\u002Flocalhost:8080\u002Fmanager\u002Flogin`\n3. Enter your API URL and `GLOBAL_API_KEY`\n4. Complete the license registration flow\n5. Once activated, the API is fully operational\n\nThe license status persists in the database (`runtime_configs` table). Heartbeats are sent periodically to maintain activation.\n\n---\n\n## API Documentation\n\nSwagger UI available at:\n\n```\nhttp:\u002F\u002Flocalhost:8080\u002Fswagger\u002Findex.html\n```\n\n### Key Endpoints\n\n| Method | Endpoint | Description |\n|---|---|---|\n| `POST` | `\u002Finstance\u002Fcreate` | Create WhatsApp instance |\n| `GET` | `\u002Finstance\u002F{name}\u002Fqrcode` | Get QR code for pairing |\n| `POST` | `\u002Fmessage\u002FsendText` | Send text message |\n| `POST` | `\u002Fmessage\u002FsendMedia` | Send media message |\n| `GET` | `\u002Finstance\u002F{name}\u002Fstatus` | Get instance status |\n| `DELETE` | `\u002Finstance\u002F{name}` | Delete instance |\n\n---\n\n## Project Structure\n\n```\nevolution-go\u002F\n├── cmd\u002Fevolution-go\u002F     # Application entry point\n├── pkg\u002F\n│   ├── core\u002F            # License management & middleware\n│   ├── instance\u002F        # Instance management\n│   ├── message\u002F         # Message handling\n│   ├── sendMessage\u002F     # Message sending\n│   ├── routes\u002F          # HTTP routes\n│   ├── middleware\u002F      # Auth & validation middleware\n│   ├── config\u002F          # Configuration\n│   ├── events\u002F          # Event producers (AMQP, NATS, Webhook, WS)\n│   └── storage\u002F         # Media storage (MinIO)\n├── docs\u002F                # Swagger documentation\n├── Dockerfile\n├── Makefile\n└── VERSION\n```\n\n---\n\n## Tech Stack\n\n| Component | Technology |\n|---|---|\n| Language | Go 1.24+ |\n| HTTP framework | Gin |\n| WhatsApp | [whatsmeow](https:\u002F\u002Fgithub.com\u002Ftulir\u002Fwhatsmeow) |\n| Database | PostgreSQL |\n| ORM | GORM |\n| Message queue | RabbitMQ, NATS |\n| Object storage | MinIO\u002FS3 |\n| Documentation | Swagger\u002FOpenAPI |\n| Container | Docker |\n\n---\n\n## Documentation\n\n| Resource | Link |\n|---|---|\n| Website | [evolutionfoundation.com.br](https:\u002F\u002Fevolutionfoundation.com.br) |\n| Documentation | [docs.evolutionfoundation.com.br](https:\u002F\u002Fdocs.evolutionfoundation.com.br) |\n| Community | [evolutionfoundation.com.br\u002Fcommunity](https:\u002F\u002Fevolutionfoundation.com.br\u002Fcommunity) |\n| Docker Hub | [evoapicloud\u002Fevolution-go](https:\u002F\u002Fhub.docker.com\u002Fr\u002Fevoapicloud\u002Fevolution-go) |\n| Changelog | [CHANGELOG.md](.\u002FCHANGELOG.md) |\n| Contributing | [CONTRIBUTING.md](.\u002FCONTRIBUTING.md) |\n| Security | [SECURITY.md](.\u002FSECURITY.md) |\n\n---\n\n## Hosting\n\nDeploy Evolution Go with optimized infrastructure through our HostGator partnership:\n\n[**Evolution Go VPS — HostGator**](https:\u002F\u002Fevolution-api.com\u002Fvps-evolution-go)\n\n---\n\n## Telemetry\n\nEvolution Go collects anonymous telemetry data (routes used, API version) to help improve the service. **No sensitive or personal data is collected.**\n\n---\n\n## Contributing\n\nContributions are welcome! Please read [CONTRIBUTING.md](.\u002FCONTRIBUTING.md) for guidelines on how to submit issues, propose features, and open pull requests.\n\nJoin our [community](https:\u002F\u002Fevolutionfoundation.com.br\u002Fcommunity) to discuss ideas 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](.\u002FSECURITY.md) for details.\n\n---\n\n## Acknowledgments\n\n- [whatsmeow](https:\u002F\u002Fgithub.com\u002Ftulir\u002Fwhatsmeow) by [Tulir Asokan](https:\u002F\u002Fgithub.com\u002Ftulir) — WhatsApp protocol library\n- [Evolution API](https:\u002F\u002Fgithub.com\u002Fevolution-foundation\u002Fevolution-api) — Node.js sister project\n\n---\n\n## License\n\nEvolution Go is licensed under the Apache License 2.0, with additional brand-protection conditions (LOGO\u002Fcopyright preservation and Usage Notification requirement). See [LICENSE](.\u002FLICENSE) for full details.\n\nFor licensing inquiries, contact **suporte@evofoundation.com.br**.\n\n## Trademarks\n\n\"Evolution Foundation\", \"Evolution\" and \"Evolution Go\" are trademarks of Evolution Foundation. See [TRADEMARKS.md](.\u002FTRADEMARKS.md) for the brand assets policy.\n\nThird-party attributions are documented in [NOTICE](.\u002FNOTICE).\n\n---\n\n\u003Cp align=\"center\">\n  Made by \u003Ca href=\"https:\u002F\u002Fevolutionfoundation.com.br\">Evolution Foundation\u003C\u002Fa> · © 2026\n\u003C\u002Fp>\n","Evolution Go 是一个基于 Go 语言开发的高性能 WhatsApp 集成 API，用于在服务端安全、稳定地接入 WhatsApp 个人账号（通过 whatsmeow 协议库实现）。它提供 RESTful 接口、WebSocket\u002FWebhook\u002FNATS 实时事件通知、媒体文件存储（支持 MinIO\u002FS3）、可选 PostgreSQL 消息持久化、QR 码扫码绑定及内置许可证管理。适用于客服系统、CRM 集成、自动化营销和企业级消息中台等需要 WhatsApp 通道对接的场景。",2,"trending"]