Frappe Assistant Core

Talk to your ERPNext site. FAC lets Claude, ChatGPT, and other MCP-ready LLMs work directly with your invoices, customers, stock, workflows, and custom apps — inside your ERPNext permissions, with every call logged.

---

New in FAC 3.0: FAC Chat

FAC 3.0 introduces FAC Chat — an opt-in, in-Frappe AI chat assistant powered by FAC Cloud, our managed service. What it does, what it costs and how to sign up: https://fac-suite.com.

FAC now offers two ways to use it:

• BYO-LLM (MCP server, free) — the original FAC. Connect any MCP-ready LLM client (Claude Desktop, Cursor, ChatGPT desktop, etc.) to your Frappe data over MCP. You bring the LLM, you pay your own LLM bill, nothing leaves your stack. Ships enabled by default.
• FAC Chat (in-Frappe chat UI, SaaS) — opt-in. A native chat widget on every Desk page plus a full-screen SPA at /copilot, powered exclusively by FAC Cloud. One subscription covers LLM access across providers, conversation memory, RAG, and workflow automation. Ships disabled by default. See https://fac-suite.com.

The split is intentional: BYO-LLM keeps the existing free MCP path untouched; FAC Chat is the managed experience for teams that want the chat inside Frappe without wiring up their own LLM keys. See FAC Chat below for full details.

---

What you get

Once FAC is installed, your team can ask an LLM for things they'd normally do by hand:

"Show me overdue invoices from our top five customers."

"Update this lead's status to Qualified and set next action date to Monday."

"Run the monthly revenue report and summarise the top movers."

"How much stock of SKU-1234 do we have across all warehouses?"

Behind that simple interaction, FAC exposes 24 built-in tools for the things your team does every day — document CRUD, search, reports, workflows, analytics, file extraction, and dashboards. Admins can publish Skills (reusable instructions that teach the LLM how to handle a specific job) and Prompt Templates (saved starting points users can pick from the admin UI) so answers stay consistent and use the right reports. The LLM authenticates over OAuth 2.0 as a real ERPNext user, so it only sees data that user can already see in the desk. Every call is recorded in the Assistant Audit Log.

It's a Frappe app, so developers can extend the toolset from their own Frappe apps through a hook — your data model, your business logic, scoped per your app.

Your data stays in your site. You control which LLM connects.

---

Quick start

Two install paths depending on how you run Frappe.

On Frappe Cloud (recommended)

1. Go to your site's Apps tab in the Frappe Cloud dashboard.
2. Find Frappe Assistant Core in the marketplace and click Install.
3. Frappe Cloud installs and migrates the app for you.

Marketplace: https://cloud.frappe.io/marketplace/apps/frappe_assistant_core

On self-hosted bench

cd frappe-bench
bench get-app https://github.com/buildswithpaul/Frappe_Assistant_Core
bench --site <your-site> install-app frappe_assistant_core

Node 22+ is needed only to build the FAC Chat UI. The assets are built on your instance rather than shipped pre-built, so a bench on an older Node will fail that build step. Upgrade Node to 22 and re-run bench build. A site using FAC purely as an MCP server does not need this.