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 →

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.