Getting Started with AutoKitteh: Build Your First Event-Driven Automation

Getting started with AutoKitteh

In this tutorial you'll build your first event-driven automation with AutoKitteh. The only requirements are Docker and a few minutes of your time.

Step 1 — Run the server

Pull the official image and start the server. AutoKitteh listens on port 8080 and stores its state in a local volume, so your sessions survive container restarts:

docker run -d --name autokitteh -p 8080:8080 -v $(pwd)/ak_data:/data ghcr.io/autokitteh/autokitteh:latest

Step 2 — Connect an event source

Use the CLI to register a webhook trigger, or connect a built-in integration such as Slack or GitHub. AutoKitteh turns each incoming event into a session — a durable execution context that keeps its state even if the process restarts.

Step 3 — Write your workflow

Workflows are just code. A minimal example reacts to a webhook and calls an AI agent as a step:

def on_event(event):
    result = ai_agent.invoke("Summarize: " + event.data)
    return result

That's it — AutoKitteh handles retries, persistence, and observability for you. You can test everything locally with the VS Code extension before deploying.

Step 4 — Deploy and monitor

Deploy your workflow with a single CLI command, then watch execution traces in the web UI. If a step fails, AutoKitteh retries automatically with backoff — no more silent failures in cron logs.