RAG Service

A complete RAG service with admin dashboard for managing your knowledge base.

Getting Started

Step 1: Create a Zeabur Project

Go to Zeabur Dashboard and create a new project.

Step 2: Enable InsForge

In your project, go to Integration → InsForge → Enable InsForge. Additional charges may apply based on usage (pricing details).

Step 3: Get InsForge Credentials

After enabling, open InsForge and go to Project Settings → API to find:

• Project URL (INSFORGE_URL): e.g. https://xxx.us-east.insforge.app
• API Key (INSFORGE_API_KEY): starts with ik_...
• Anon Key (INSFORGE_KEY): starts with eyJ...

Step 4: Deploy RAG Service

In your project, click Add Service → Marketplace, search for RAG Service, and fill in:

• The three InsForge credentials from Step 3
• Zeabur AI Hub API Key: can be generated during deployment, or created in advance at Zeabur AI Hub

Schema migrations run automatically on first startup — no manual setup needed.

Features

• Hybrid search: semantic (pgvector) + BM25 keyword with RRF fusion
• Streaming RAG answers via configurable LLM model
• Admin dashboard: chunk browser, query signals, reports, audit log
• API key management with scopes and expiry
• Knowledge learning API: add new chunks via /api/learn
• Feedback collection on query results

API Endpoints

Endpoint	Method	Description
/api/query	POST	RAG search + answer
/api/learn	POST	Add knowledge chunks
/api/report	POST	Report data issues
/api/feedback	POST	Submit feedback
/api/admin/*	GET/POST	Admin API (API key management, signals, reports, chunks)
/dashboard	GET	Admin dashboard (Basic Auth)

Environment Variables

Variable	Required	Description
INSFORGE_URL	Yes	InsForge backend URL
INSFORGE_KEY	Yes	InsForge anon key
INSFORGE_API_KEY	Yes	InsForge API key (ik_...) for schema migration
ZEABUR_AI_HUB_API_KEY	Yes	Zeabur AI Hub key for LLM inference
RAG_API_KEY	Auto	API key for service access (auto-generated)
RAG_BASIC_AUTH	Auto	Dashboard auth (auto-generated, format admin:password)
RAG_MODEL	No	LLM model (default: gemini-2.5-flash-lite)
CORS_ORIGIN	No	CORS origin (default: service URL)

Schema migrations run automatically on first startup.

License

MIT — Built by Zeabur