Frappe Connect

Bidirectional event bridge between Frappe/ERPNext and Apache Fineract via Apache Kafka.

Install Frappe Connect

bench get-app https://github.com/wilfriedago/frappe-connect

Add the Frappe Gems badge to your README

Maintain Frappe Connect? Paste this into your README:

[![Listed on Frappe Gems](https://frappegems.com/api/method/frappe_gems.seo.badge?app=wilfriedago%2Ffrappe-connect)](https://frappegems.com/gems/apps/wilfriedago/frappe-connect)

About Frappe Connect

Connect — Kafka-Fineract Integration Bridge

Bidirectional event bridge between Frappe/ERPNext and Apache Fineract via Apache Kafka.

Features

  • Producer: Translates Frappe document lifecycle events into Fineract external commands
  • Consumer: Translates Fineract business events back into Frappe document actions
  • Configuration-driven: New commands/events added via DocTypes, not code
  • Two-tier Avro serialization: Inner raw payload + Confluent Schema Registry envelope
  • Three-layer schema cache: Redis → MariaDB → Schema Registry
  • Full observability: Every message logged with status tracking and correlation

Prerequisites

  • librdkafka installed (brew install librdkafka on macOS, apt-get install librdkafka-dev on Debian)
  • Apache Kafka + Confluent Schema Registry (see docker-compose.kafka.yml)
  • Frappe Tweaks app installed (for Sync Job support)

Installation

bench get-app connect
bench --site your-site install-app connect
bench --site your-site migrate

Setup

  1. Start Kafka infrastructure: docker compose -f docker-compose.kafka.yml up -d
  2. Configure Fineract Kafka Settings in Desk
  3. Create Fineract Event Emission Rules for producer
  4. Create Fineract Event Handlers for consumer
  5. Start consumer: bench connect-consumer --site your-site

Architecture

See plan.md for the full architecture document.

License

MIT

Related Integrations apps for Frappe & ERPNext

  • Insights — Open Source Business Intelligence Tool
  • Raven — Simple, open source team messaging platform
  • Frappe Whatsapp — WhatsApp cloud integration for frappe
  • Frappe Assistant Core — Infrastructure that connects LLMs to ERPNext. Frappe Assistant Core works with the Model Context Protocol (MCP) to expose ERPNext functionality to any compatible Language Model
  • Biometric Attendance Sync Tool — A simple tool for syncing Biometric Attendance data with your ERPNext server
  • Frappe React Sdk — React hooks for Frappe
  • Frappe Js Sdk — TypeScript/JavaScript library for Frappe REST API
  • Mcp — Frappe MCP allows Frappe apps to function as MCP servers