Start here

You do not need to read every concept before you start. Pick the path that matches your project, complete the local loop, then return to architecture and advanced capabilities when they become useful.

First, make one project work

Python Agent: Quickstart

For a new LangGraph Agent; includes installation, model configuration, terminal running, and the Web UI.

✨ Codex: YAML Is the Agent

For a Codex coding Agent; no agent.py is generated and Docker is not required.

Existing Agent

For existing Python code; create a project wrapper that KsADK can detect reliably.

Then make it maintainable

Configuration

Precedence across YAML, .env, global defaults, and command-line overrides.

Project structure

The files required by a Python Agent versus a YAML Codex manifest.

Local Web UI

Inspect conversations, tool calls, uploaded files, and sessions in the browser.

Learn the design when needed

Core concepts

Projects, Runners, Sessions, Transcripts, Attachments, and Workspaces.

Why KsADK

The boundary between an Agent framework, a Runtime, and the platform.

Architecture and ecosystem

Read the public Runtime boundary; use ecosystem comparison when making a framework choice.