Open-source AI assistant for ERPNext — ask business questions in plain English, get instant answers. No SQL needed.
Setup Guide · Documentation · Report a Bug · Embedding Model 🤗
⚠️ Note: Current version is trained on ERPNext modules only. Like any AI model, it is still learning — it handles a good range of ERPNext queries well but will not get everything right. Accuracy improves over time with more training data and feedback.
# 1. Get the app
bench get-app changai https://github.com/erpgulf/changai
# 2. Install on your site
bench --site your-site.local install-app changai
# 3. Migrate & restart
bench --site your-site.local migrate
bench restartThen search for changAI Settings in ERPNext to configure your deployment mode.
changAI supports two deployment modes:
Schema retrieval runs locally; SQL is generated via Gemini.
- Uncheck Remote in changAI Settings
- Enter your Gemini API credentials
Both schema retrieval and SQL generation run on Replicate using Qwen3.
- Check Remote in changAI Settings
- Fill in your Replicate API token, prediction URL, and version IDs under the Remote tab
📺 Full walkthrough: YouTube Setup Guide
📖 Full docs: docs.claudion.com
| Feature | Description |
|---|---|
| Chat Tab | Ask ERPNext questions in plain English and get instant answers |
| Debug Tab | Inspect pipeline outputs at each stage of the query |
| Support Tab | Built-in support interface (work in progress) |
| Train Data Automation | Auto-generate training data by ERPNext module |
| Master Data Schema | Create and sync schema + master records |
| Download Embedding Model | Download updated model to disk — auto-downloads on first install; only needed again on model updates |
User Query
│
▼
RAG Retrieval ──── Retrieves relevant tables, fields & master records
│
▼
SQL Generation ─── LLM generates SQL from retrieved schema context
│
▼
Permission Check ── Validated via Frappe's match_conditions API
│
▼
Natural Language ── Result returned as a human-readable answer
| Component | Local Mode | Remote Mode |
|---|---|---|
| Embeddings | hyrinmansoor/changAI-nomic-embed-text-v1.5-finetuned |
hyrinmansoor/changAI-nomic-embed-text-v1.5-finetuned |
| Schema Retrieval | Local | Replicate |
| SQL Generation | Gemini | Qwen3 (Replicate) |
PRs are welcome.
- Fork the repository
- Branch from
main - Submit a pull request
Reporting bugs: Open a GitHub Issue and include:
- Your query
- The output received
- Any error messages
- Debug tab output
| 📺 Setup Walkthrough | youtu.be/twD-4scH-EM |
| 📖 Documentation | docs.claudion.com |
| 🤗 Embedding Model | huggingface.co/hyrinmansoor/changAI-nomic-embed-text-v1.5-finetuned |
| 🤗 Dataset | huggingface.co/datasets/hyrinmansoor/ERP-retrieval-data-modernbert |
| 🐛 Issues | github.com/ERPGulf/changAI/issues |
| 📧 Support | support@erpgulf.com |
| 🌍 Website | erpgulf.com |
MIT License · Actively maintained · Built by ERPGulf