HookBridge — Open-Source Webhook Infrastructure with Kafka, Retries, DLQ, Observability & AI Failure Analysis
HookBridge is a self-hosted webhook infrastructure platform for reliable event delivery, retry workflows, dead-letter queues, observability, and AI-powered failure analysis.
If HookBridge helps you, please ⭐ star the repository. It helps the project reach more developers.
- Why HookBridge?
- Who is HookBridge for?
- Key Features
- Agentic AI Roadmap (Experimental)
- Tech Stack
- Architecture
- Quick Start
- Docker Compose
- Screenshots
- Why Sponsor HookBridge?
- Contributing
- Good First Issues
- Documentation
- License
HookBridge is built for teams that need a reliable webhook infrastructure and event processing platform without handing critical delivery workflows to a third-party SaaS.
- Reliable webhook delivery for production-grade event flows.
- Kafka-based async processing for high-throughput webhook ingestion.
- Webhook retry and webhook dead letter queue (DLQ) workflow with replay support.
- Self-hosted webhook platform controls deployment, security, and operations.
- MongoDB persistence for events, delivery attempts, and operational metadata.
- Webhook observability via dashboard, delivery logs, and health insights.
- Docker/Kubernetes ready for local and cloud-native deployments.
- API-first development with Swagger/OpenAPI.
- AI-powered failure analysis and remediation recommendations.
- SaaS platforms.
- E-commerce platforms.
- Logistics systems.
- FinTech and payment systems.
- ERP/CRM integration teams.
- Developer teams building webhook infrastructure.
- Startups that want self-hosted webhook processing.
- Webhook ingestion API.
- Event persistence.
- Kafka webhook processing workers.
- Webhook retry with exponential backoff.
- Webhook dead letter queue (DLQ).
- Replay and reprocess support.
- Delivery logs.
- Endpoint health monitoring.
- Observability dashboard.
- AI failure analysis.
- AI retry recommendation.
- Admin approval workflow.
- Safe mode for AI actions.
- API documentation with Swagger/OpenAPI.
- CloudEvents support for interoperable event delivery.
These items are roadmap/experimental and may be partially implemented or under active development.
- Retry Agent.
- Security Agent.
- Transformation Agent.
- Observability Agent.
- Dead-letter AI analysis.
- Natural Language Query API.
- AI Decision Audit Trail.
- Human Approval Workflow.
- AI Safe Mode.
See docs/ROADMAP.md for phased details.
- .NET 8
- ASP.NET Core
- Kafka
- MongoDB
- Docker
- Kubernetes
- OpenAPI/Swagger
- GitHub Actions
- Ollama + Semantic Kernel for optional AI features
Webhook → API → Kafka → Worker → MongoDB → Retry/DLQ → Dashboard
For deeper details, see docs/architecture.md.
git clone https://github.com/skm00/HookBridge.git
cd HookBridge
docker compose -f deploy/docker-compose.yml up -d- API URL:
http://localhost:5000 - Swagger URL:
http://localhost:5000/swagger - Dashboard URL:
http://localhost:5173(when running dashboard locally)
HookBridge includes local development support with Docker Compose for core infrastructure dependencies including Kafka and MongoDB. Use deploy/docker-compose.yml to run local services, then run API/worker/dashboard as needed for end-to-end webhook delivery, retry workflow validation, and DLQ operations.
HookBridge is open-source webhook infrastructure for teams that need reliable event delivery, retry workflows, DLQ handling, observability, and AI-powered failure analysis.
Your sponsorship helps support:
- Core development and maintenance
- More tests and better reliability
- Docker and Kubernetes deployment improvements
- Observability dashboard improvements
- AI-powered debugging and recommendation features
- Security updates and dependency maintenance
- Documentation, examples, and tutorials
If HookBridge saves your team engineering time or helps you avoid building webhook infrastructure from scratch, please consider sponsoring the project.
Contributions are welcome. Please read CONTRIBUTING.md and CODE_OF_CONDUCT.md before opening issues or pull requests.
- Fork the repo.
- Create a feature branch.
- Add or update tests for your change.
- Open a pull request.
- Follow coding style and existing architecture patterns.
- Maintain or improve coverage expectations enforced in CI.
See CONTRIBUTING.md for details.
- Documentation improvements.
- More dashboard screenshots.
- Docker Compose improvements.
- Unit tests.
- Kafka examples.
- MongoDB indexing improvements.
- UI improvements.
- AI Worker documentation
- Dead-letter AI analysis
- Deployment guide
- Architecture deep dive
- Security notes
See the repository license terms and current status in project metadata.