Kubiya LogoKubiya Developer Docs

Getting Started with Kubiya

Learn how to get started with the Kubiya platform for AI agents orchestration, management, and consumption.

Getting Started with Kubiya

Welcome to Kubiya! This guide will walk you through the essential steps to start building, managing, and deploying AI agents that can perform tasks within your organization's systems and workflows.

What is Kubiya?

Kubiya is a platform that enables you to create, orchestrate, and consume AI agents. It bridges the gap between your team, your infrastructure, and AI capabilities by providing:

  • Intelligent Agents: Create AI agents with specific skills, tools, and knowledge
  • Multi-tool Integration: Connect agents to your existing infrastructure, tools, and services
  • Multiple Access Methods: Interact via Web UI, CLI, API, or chat integrations (Slack, Microsoft Teams)
  • Enterprise Controls: Maintain governance with security, permissions, and audit logs

Kubiya Architecture

Kubiya Runner Architecture
React Flow

Before You Begin

To get started with Kubiya, you'll need:

  • A Kubiya account (sign up at app.kubiya.ai)
  • Access to at least one of the following for deployment:
    • CLI access for local development
    • Kubernetes cluster for production deployment
    • Docker environment for container execution

Kubiya offers both cloud and self-hosted options. This guide covers both approaches.

Quick Start

Sign up for Kubiya

Create an account at app.kubiya.ai or log in if you already have one. You can authenticate with email or SSO if enabled by your organization.

Install the CLI (Optional)

Install the Kubiya CLI for local development and management:

# Linux (Ubuntu/Debian):
sudo apt-get update
sudo apt-get install kubiya-cli
 
# Or download binary directly from GitHub releases:
# https://github.com/kubiyabot/cli/releases

For detailed installation instructions, see the CLI Installation Guide.

Set up your environment

Configure your environment for agent deployment:

# Log in to Kubiya
kubiya login
 
# Initialize a new project
kubiya init my-first-agent

Create your first agent

Create an agent through one of the available methods:

  • Web UI: Design agents through the Kubiya dashboard
  • CLI: Define agents in YAML and deploy via the command line
  • Terraform: Define agents as infrastructure code

Usage Methods

There are multiple ways to work with Kubiya agents:

Web UI

Create and manage agents through an intuitive interface with immediate testing and deployment.

CLI

Define and deploy agents via command-line for automation and CI/CD integration.

Terraform

Manage agents as infrastructure-as-code for version control and consistent environments.

REST API

Integrate agent capabilities directly into applications and services programmatically.

Interaction Methods

Once your agents are deployed, you can interact with them through multiple channels:

Slack

Access agents directly from Slack channels with slash commands and direct messaging.

Microsoft Teams

Integrate agents with Microsoft Teams for direct messaging and team-wide access.

Web Chat

Embed agent chat interfaces directly in your applications and internal portals.

API Direct

Directly integrate agent functionality via API calls for system-to-system automation.

Core Concepts

Agents

Understand how agents are structured, trained, and deployed.

Tools

Learn how tools extend agent capabilities to perform specific tasks.

Knowledge Sources

Discover how to provide relevant context to your agents.

Security & Governance

Explore access controls, audit logs, and compliance features.

Platform Features

Kubiya helps you:

  • Build once, deploy anywhere: Define agents that work across channels and environments
  • Enhance with tools: Connect to existing systems and services through agentic tools
  • Control access: Granular permissions and approval flows for sensitive operations
  • Monitor usage: Track agent performance, usage patterns, and success metrics

New to Kubiya? Check out our Getting Started Guide to build your first agent in minutes.

CLI Reference

Command-line interface for the Kubiya Agentic Platform.

On this page