Skip to content

QelosAI-First Application Layer Gateway

The backend layer your app plugs into β€” REST API, AI agents, auth, workspaces, permissions, and events log out of the box.

Qelos

What is Qelos? ​

Qelos is the AI-first application layer gateway. It plays three roles for your app:

πŸ› οΈ Admin panel

Manage data models, AI agents, users, workspaces, permissions, and events from a single dashboard.

🌐 API gateway

RESTful endpoints backed by MongoDB. Blueprints define the data model; CRUD, AI chat, and auth come for free.

🧩 Plugin for every framework

@qelos/integrator-* middleware makes Qelos the API for your Next.js, Nuxt, Express, Fastify, NestJS, or FastAPI app.

Pick your path ​

πŸš€ Integrate Qelos into your app

Install the CLI, drop in the integrator for your framework, and start calling the SDK.

Getting Started as an Integrator β†’

🏁 Run Qelos locally

Clone the repo, start the dev environment, and explore the admin panel.

Installation guide β†’

🧰 Use the SDK

Entities, AI agents, auth, permissions, workspaces, and events β€” one client surface.

Read the SDK reference β†’

⌨️ Use the CLI

qelos init, qelos generate rules, qelos dev, qelos pull/push β€” your day-to-day developer tool.

Go to the CLI docs β†’

πŸ€– Build with AI agents

Create agents in the admin panel, then embed them in your app via the SDK or web widget.

Open the AI agents guide β†’

πŸ”Œ Browse integrators

Per-framework setup guides for Express, Next.js, Nuxt, Fastify, NestJS, and FastAPI.

See available integrators β†’

πŸ”— Connect AI clients via MCP

Expose tenant tools to Cursor, Claude, ChatGPT, and other MCP clients β€” configure access from the admin panel.

MCP setup guide β†’

Quick start ​

Integrate Qelos in an existing app ​

bash
# 1. Install the CLI
npm install -g @qelos/cli

# 2. Initialize in your project (detects framework, scaffolds config)
qelos init

# 3. Install the integrator for your framework
npm install @qelos/integrator-next   # or express, nuxt, fastify, nest

# 4. Install the SDK
npm install @qelos/sdk
typescript
import QelosSDK from '@qelos/sdk';

const sdk = new QelosSDK({
  appUrl: 'https://your-qelos-instance.com',
  apiToken: 'ql_your_api_token_here',
});

// Query entities defined in your blueprints
const products = await sdk.entities('products').find({ status: 'active' });

// Chat with an AI agent
const reply = await sdk.ai.agents.chat('agent-id', 'How can I help?');

// Check permissions
const allowed = await sdk.permissions.check('products:write');

Run Qelos locally ​

bash
git clone https://github.com/qelos-io/qelos.git
cd qelos
pnpm install      # install dependencies
pnpm build        # build packages
pnpm dev          # start the dev environment (includes MongoDB)
pnpm populate-db  # seed initial data (in a new terminal)

Log in at http://localhost:3000/ with test@test.com / admin.

🧭 Create blueprints

Design data models that turn into REST resources automatically.

Learn more β†’

πŸ€– Configure your first AI agent

Wire up an agent end-to-end and chat with it from your app.

Open the tutorial β†’

πŸ” Auth & permissions

Email/password, social login, cookie tokens, roles, and resource-level access.

Browse auth docs β†’

πŸ“‘ Gateway endpoint reference

Every gateway route mapped to its SDK call and a curl example.

Open the reference β†’

🧩 Build a plugin

Plugins, custom endpoints, and micro-frontends for your Qelos instance.

Create a plugin β†’

🚒 Deploy

Docker Compose, Kubernetes / Helm, and the production checklist.

Deployment guide β†’

Build SaaS Products Without Limits.