A standalone administration console for RAGFlow
RAGFlow Admin is a lightweight, standalone administration console for RAGFlow — the leading open-source RAG engine with deep document understanding. It provides a modern web interface for centralized management of datasets, documents, chat assistants, agents, and users.
RAGFlow is a powerful RAG engine, but its built-in management interface has some limitations for production use:
| Pain Point | RAGFlow Admin Solution |
|---|---|
| Single dataset view | Cross-dataset dashboard for unified management |
| No batch operations | Bulk upload, parse, stop, and delete across datasets |
| Hidden task queue | Real-time task monitoring with queue position and progress |
| Complex user management | Centralized user admin panel with statistics |
| Limited operational insight | Dashboard with health checks and usage metrics |
| Steep learning curve | Intuitive UI designed for administrators |
| Feature | Description |
|---|---|
| 📚 Dataset Management | View all datasets across users, create, delete with batch operations |
| 📄 Document Management | Upload, parse, stop, delete documents with real-time progress tracking |
| 📊 Task Queue | Global task monitoring across all datasets with queue position, filtering and batch control |
| Feature | Description |
|---|---|
| 💬 Chat Management | View and manage chat assistants and conversation sessions |
| 🤖 Agent Management | List and manage AI agents across users |
| 👥 User Management | View RAGFlow users with statistics (requires MySQL access) |
| 🔍 System Monitoring | Dashboard with service health checks and usage statistics |
| 🌐 i18n Support | Full internationalization (English & Chinese) |
- A running RAGFlow instance (v0.15+)
- Docker 20.10+ & Docker Compose 2.0+ (for Docker deployment)
- Python 3.10+ & Node.js 18+ (for source deployment)
$ git clone https://github.com/tedhappy/ragflow-admin.git
$ cd ragflow-admin/docker
$ docker compose -f docker-compose.yml up -dCheck server status:
$ docker logs -f ragflow-adminOpen http://localhost:8000, login with admin/admin, and configure MySQL via Settings page.
See docker/README.md for advanced configuration.
$ git clone https://github.com/tedhappy/ragflow-admin.git
$ cd ragflow-admin
$ cp conf/config.example.yaml conf/config.yaml$ pip install -r requirements.txt
$ python -m api.server$ cd web
$ npm install
$ npm run devOpen http://localhost:8000 to access the admin console.
ragflow-admin/
├── api/ # Backend (Python/Quart)
│ ├── apps/ # API route handlers
│ ├── services/ # Business logic
│ └── server.py # Application entry point
│
├── web/ # Frontend (React/UmiJS)
│ └── src/
│ ├── pages/ # Page components
│ ├── components/ # Reusable UI components
│ ├── services/ # API client
│ └── locales/ # i18n translations
│
├── docker/ # Docker configuration
│ ├── docker-compose.yml # Docker Compose file
│ ├── .env # Environment variables
│ ├── entrypoint.sh # Container entrypoint
│ ├── spa_server.py # Frontend SPA server
│ └── README.md # Docker deployment guide
│
├── conf/ # Configuration files
├── Dockerfile # Docker build file
└── docs/ # Documentation
| Layer | Technology |
|---|---|
| Backend | Python 3.10+ / Quart |
| RAGFlow Integration | ragflow-sdk |
| Frontend | React 18 / UmiJS 4 / TypeScript |
| UI Components | Ant Design 5 |
| Styling | TailwindCSS 4 |
| State Management | React Query / Zustand |
| i18n | i18next |
| Database | MySQL |
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
- RAGFlow - The RAG engine this project manages
- RAGFlow Documentation
- RAGFlow Python SDK
- RAGFlow HTTP API
This project is licensed under the Apache License 2.0.
If you find this project helpful, please consider giving it a ⭐️