# Qarinai > Create unlimited AI chatbot agents for your website — powered by OpenAI-compatible LLMs, RAG, and MCP. - **Type:** MCP server - **Install:** `agentstack add mcp-qarinai-qarinai` - **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior - **Seller:** [qarinai](https://agentstack.voostack.com/s/qarinai) - **Installs:** 0 - **Category:** [Cloud & Infrastructure](https://agentstack.voostack.com/c/cloud-infrastructure) - **Latest version:** 0.1.0 - **License:** Apache-2.0 - **Upstream author:** [qarinai](https://github.com/qarinai) - **Source:** https://github.com/qarinai/qarinai - **Website:** https://qarin.ai ## Install ```sh agentstack add mcp-qarinai-qarinai ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About Qarīn.ai Your AI Companion 🚧 STILL UNDER DEVELOPMENT — NOT READY FOR PRODUCTION USE 🚧 Create unlimited AI Chatbot Agents for your websites --- ## 📌 Overview **Qarīn.ai** lets you **create unlimited AI chatbot agents** for your websites — no coding required. It works with any LLM provider that supports the **OpenAI-Compatible API**, including self-hosted providers like **llama.cpp** or **Ollama**. With Qarīn.ai, you can: - Define an agent's **name, identity, and instructions**. - Instantly generate a **chat bubble widget** to embed on your site. - **Enhance agents** by connecting to **MCP Servers** or importing your own API specs. - Build **vector stores** from documents for retrieval-augmented generation (RAG). - Expose vector stores or MCP Servers to **external AI agents**. --- ## ✨ Highlights - **No Coding Needed!** - Supports **RAG** & **MCP** out of the box. - Works with **any OpenAI-Compatible LLM provider** (including self-hosted). - **One-click MCP Server generation** from existing REST API specs (Swagger/OpenAPI). - Native **vector storage** with optional MCP Server exposure for each store. - **Easy-to-use chat bubble widget** for quick website integration. - Simple Docker or Kubernetes deployment. --- ## 🚀 Quick Start (Docker Compose) **Requirements** - Docker & Docker Compose installed. **Run Qarīn.ai** ```bash git clone https://github.com/qarinai/qarinai.git cd qarinai docker compose up -d ``` This starts Qarīn.ai with all required environment variables pre-configured. ### Default Login Credentials - Username: `admin` - Password: `admin` --- ## 🛠 Creating Your First Agent Once running: 1. Connect your desired LLM provider (OpenAI, Ollama, llama.cpp, etc.). 2. Select the models you want to use. 3. Set a default model for minor app tasks (summarization, descriptions, etc.). 4. (Optional) Import MCP Servers into Qarīn.ai. 5. (Optional) Import Swagger/OpenAPI specs to auto-generate MCP Servers. 6. (Optional) Create vector stores and upload documents for RAG. 7. Create your AI agent — define name, identity, and instructions. 8. Embed it — click “Add to Website” to get your dynamic snippet code. --- ## 🗺 Feature Roadmap Qarīn.ai is still in active development — several existing features are only partially implemented or missing certain CRUD operations and use cases. The near-term focus will be **completing and stabilizing all current functionality** before expanding further. **Planned enhancements:** - 🛠 **Complete existing CRUD operations** and missing use cases for certain resources. - 🔒 **Enhanced security**: - User management with multiple accounts and ACL (Access Control Lists). - Personal Access Tokens with **scopes** instead of full unrestricted access. - Secure the public bubble APIs. - 📊 **Conversation tracking UI**: - Visual interface to inspect each conversation and message per agent (currently only stored in DB). - 🎨 **Agent UI customization**: - Style, color, and branding customization for the chat bubble and iframe widget. - 🚀 Additional quality-of-life improvements after stabilization. --- ## 📜 License This project is licensed under the Apache 2.0 License — see [LICENSE](/LICENSE) for details. --- ## 🙏 Acknowledgements Qarīn.ai would not have been possible without the incredible work of the **open-source community**. This project stands on the shoulders of countless developers and contributors who make their tools, libraries, and frameworks available for everyone to learn from and build upon. A special thanks to the maintainers of the amazing technologies powering Qarīn.ai, including (but not limited to): - **Frontend & UI**: [Angular](https://angular.io), [PrimeNG](https://primeng.org), [TailwindCSS](https://tailwindcss.com), [ngx-markdown](https://github.com/jfcere/ngx-markdown) - **Backend & APIs**: [NestJS](https://nestjs.com), [@modelcontextprotocol/sdk](https://github.com/modelcontextprotocol), [OpenAI SDK](https://platform.openai.com), [Zod](https://zod.dev) - **AI & NLP**: [@huggingface/transformers](https://huggingface.co/docs/transformers/index), [@langchain/textsplitters](https://js.langchain.com/docs/modules/data_connection/document_transformers/text_splitters) - **Database & Storage**: [TypeORM](https://typeorm.io), [PostgreSQL](https://www.postgresql.org), [pgvector](https://github.com/pgvector/pgvector) - **Build & Tooling**: [Webpack](https://webpack.js.org), [Gulp](https://gulpjs.com), [Docker](https://www.docker.com) - **And many more...** — every dependency plays a role in making this project possible. If you maintain one of these libraries: **thank you** for your dedication to open-source! ❤️ --- ## 🤝 Contributing Contributions are not open at the moment as the project is still in an early stage. However, suggestions and feedback are welcome — feel free to open an issue or discussion. ## Source & license This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code. - **Author:** [qarinai](https://github.com/qarinai) - **Source:** [qarinai/qarinai](https://github.com/qarinai/qarinai) - **License:** Apache-2.0 - **Homepage:** https://qarin.ai Install and usage instructions live in the source repository linked above. ## Pricing - **Free** — Free ## Security capabilities Automated source analysis of v0.1.0 — what this tool can access: - **Network access:** no - **Filesystem access:** no - **Shell / process execution:** no - **Environment & secrets:** no - **Dynamic code execution:** no *"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.* ## Versions - **0.1.0** — security scan: passed — Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/mcp-qarinai-qarinai - Seller: https://agentstack.voostack.com/s/qarinai - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.