Tutorials

Step-by-step guides to help you build real things with Qelos. Each tutorial walks you through a complete, working example from start to finish.

Available Tutorials

🚀

Create an App & Add OpenAI Token

Add an OpenAI connection to your Qelos instance so agents can use it to power AI features in your product.

Start tutorial →

🤖

Configure Your First AI Agent

Create an AI integration, give it a persona and instructions, then chat with it through the UI, the CLI, and the SDK.

Start tutorial →

⚙️

Build an Agentic Todo Machine

Build a fully autonomous system: an AI agent generates todos, and a poller app picks them up, executes the tasks, and updates their status — all without human interaction.

Start tutorial →

Prerequisites

Before starting any tutorial, make sure you have access to a Qelos instance — either:

• Cloud (recommended): Sign up at app.qelos.io to get a fully managed instance with no setup required, or
• Self-hosted: Run Qelos locally by following the Installation Guide.

You will also need:

• The Qelos CLI installed (npm install -g @qelos/cli) and a .env file with QELOS_URL and either QELOS_USERNAME+QELOS_PASSWORD or QELOS_API_TOKEN
• Node.js v20 or later