Klisk Documentation

Build AI agents in Python with the easiest framework

Build AI Agents in Python

Klisk is the easiest way to build AI agents programmatically. Define agents and tools with a simple API, iterate with an interactive Studio, and deploy to production — all from the CLI.

Get Started

View API Reference

Quick Start

Get up and running with Klisk in minutes

1. Install Klisk

   Install the framework using pip:

   pip install klisk
   
2. Create a new project

   Scaffold a new agent project with the CLI:

   klisk create my-agent
   cd my-agent
   

   This creates a ready-to-run project with klisk.config.yaml, .env, and source files in src/.

3. Define your agent

   Edit src/main.py to define your agent:

   from klisk import define_agent, get_tools
   
   agent = define_agent(
       name="Assistant",
       instructions="You are a helpful assistant.",
       model="gpt-5.2",
       tools=get_tools("greet"),
   )
   
4. Run your agent

   Test your agent from the command line:

   klisk run "Say hello to Juan"
   

   Or start an interactive chat session:

   klisk run -i
   

Explore Klisk

Discover what makes Klisk powerful

Core Concepts

Learn about agents, tools, and how Klisk works under the hood

Interactive Studio

Visual development environment with agent graphs and live chat

Multi-Provider Support

Use any LLM provider via LiteLLM — OpenAI, Anthropic, Google, and more

Builtin Tools

Web search, code interpreter, file search, and image generation

Production Deployment

Deploy with REST API, WebSocket endpoints, and embeddable widgets

Cloud Run Deploy

One-command deployment to Google Cloud Run

Key Features

Everything you need to build production-ready AI agents

Simple API

Define agents and tools with an intuitive Python API. No boilerplate, just clean code.

Hot Reload

Changes to your code update the Studio instantly. Iterate fast without restarting.

Visual Studio

See your agent graph, test with live chat, and edit configurations from the browser.

Multi-Provider

Use OpenAI, Anthropic, Google, Mistral, and any LiteLLM-supported provider.

Ready to build your first agent?

Follow our quickstart guide to create, develop, and deploy your first AI agent with Klisk.

Start Building