# Kindgi - a full-stack AI agent framework and runtime.

> Your coding agent writes tools, agents and flows in your app's own code. Kindgi runs them in production, on your own infrastructure or hosted by us (private preview), and records every step.

## Start with your coding agent

Paste this prompt into your coding agent: Claude Code, Cursor, Codex or any other. It takes you from nothing to a first agent that answers. Along the way, you sign in, copy two values and answer one question.

```text
Set up Kindgi for me: read https://docs.kindgi.com/start/agent.md and follow it step by step. Tell me whenever you need me to do something, and wait for me.
```

[What your coding agent follows](https://docs.kindgi.com/v0.1.8/start/agent.md) · [How it knows Kindgi](https://docs.kindgi.com/v0.1.8/start/coding-agents.md)

## Quickstart

From an empty folder to an agent that answers: you run one command, and your coding agent does the rest. [Quickstart](https://docs.kindgi.com/v0.1.8/start/quickstart.md)

**Rather write it yourself?** A first pack by hand, running on your machine in ten minutes: [TypeScript](https://docs.kindgi.com/v0.1.8/start/quickstart-typescript.md), [Python](https://docs.kindgi.com/v0.1.8/start/quickstart-python.md), [Java](https://docs.kindgi.com/v0.1.8/start/quickstart-java.md) or [Scala](https://docs.kindgi.com/v0.1.8/start/quickstart-scala.md).

## What you need

- **Either Node or Python.** Which one depends on your pack's language:

  - **TypeScript:** Node 22.12 or later.
  - **Python:** Python 3.11 or later, and uv (or Poetry, or pip). The `kindgi` CLI comes from PyPI with its own copy of Node.
  - **Java or Scala (preview):** a JDK 17 or later, and Node or uv to run the CLI. A Java pack brings Maven; a Scala pack needs sbt.

- **Docker** (Docker Desktop, or the Docker engine on Linux). `kindgi dev` runs Kindgi's runtime in it on your machine.

- **Access to the runtime image:** sign in at [access.kindgi.com](https://access.kindgi.com/) with GitHub, to get the image's pull credentials and a free non-production license key, for staging and CI.

- **A model:** your model provider's API key, or an open model you serve yourself, such as Ollama on your machine, with no key.

[Install](https://docs.kindgi.com/v0.1.8/start/install.md) has the details, and `kindgi doctor` checks what Kindgi needs.

## Free on your machine, with support for local models

Everything you build and test on your machine is free: `kindgi dev` runs the runtime in development mode, which needs no license key. Your agents can run on a model on your machine too, with no API key and no cost per call. [Connect a model you serve](https://docs.kindgi.com/v0.1.8/guides/models/serve-your-own-model.md) shows how, with Ollama as the example.

Running Kindgi in production needs a commercial license. Check [Licensing](https://docs.kindgi.com/v0.1.8/concepts/licensing.md) for more details.

## The documentation

[What is Kindgi?](https://docs.kindgi.com/v0.1.8/start/introduction.md)Packs, the runtime, and how your app and your coding agent work with them.

[Add Kindgi to an existing app](https://docs.kindgi.com/v0.1.8/start/existing-app.md)Your app's own code as tools, in TypeScript, Python, Java or Scala.

[Tutorials](https://docs.kindgi.com/v0.1.8/tutorials.md)Build a support desk, step by step, in TypeScript or Python.

[Guides](https://docs.kindgi.com/v0.1.8/guides.md)How to do one thing: tools, agents, models, flows, runs, webhooks, approvals, secrets.

[Concepts](https://docs.kindgi.com/v0.1.8/concepts.md)How Kindgi works: packs, runs and the journal, the security model, licensing.

[Deploy](https://docs.kindgi.com/v0.1.8/deploy.md)Run Kindgi in your own infrastructure, or let us run it for you on Kindgi Cloud (private preview).

[Reference](https://docs.kindgi.com/v0.1.8/reference.md)Every API route, SDK export, CLI command, setting and event.

[Contributing](https://docs.kindgi.com/v0.1.8/contributing.md)How the SDK repository is organized and the rules for changes.