koin

![logo](./docs/img/koin_main_logo.png)

[![Kotlin](https://img.shields.io/badge/Kotlin-2.3.20-blue.svg?style=flat&logo=kotlin)](https://kotlinlang.org)
![Github Actions](https://github.com/InsertKoinIO/koin/actions/workflows/build.yml/badge.svg)
[![Apache 2 License](https://img.shields.io/github/license/InsertKoinIO/koin)](https://github.com/InsertKoinIO/koin/blob/main/LICENSE.txt)
[![Slack channel](https://img.shields.io/badge/Chat-Slack-orange.svg?style=flat&logo=slack)](https://kotlinlang.slack.com/messages/koin/)


# What is KOIN? ✨
 
Koin is a pragmatic, lightweight dependency injection framework for Kotlin developers, developed by [Kotzilla](https://kotzilla.io) and open-source [contributors](https://github.com/InsertKoinIO/koin/graphs/contributors).

```
The pragmatic Kotlin & Kotlin Multiplatform Dependency Injection framework
- Simple, Powerful and now Compile-Safe -
```

## Compile-Safe Dependency Injection 🛡️

Koin is now **compile-safe** thanks to the [Koin Compiler Plugin](https://github.com/InsertKoinIO/koin-compiler-plugin). Your dependency graph is verified at compile time — missing bindings, broken definitions, and misconfigured modules are caught by the compiler instead of crashing at runtime.

- Catch missing or invalid dependencies before you run your app
- Keep Koin's concise, idiomatic DSL — no extra boilerplate
- Works across Kotlin & Kotlin Multiplatform targets

Get started with the [Koin Compiler Plugin](https://github.com/InsertKoinIO/koin-compiler-plugin).


## Setup & Current Version 📦

Follow the dedicated [setup page](https://insert-koin.io/docs/setup/koin) to setup Koin for your project.
Here are the currently available Koin versions:

- **Latest** Version : [![Maven Central](https://img.shields.io/maven-central/v/io.insert-koin/koin-core)](https://mvnrepository.com/artifact/io.insert-koin/koin-core)


## Developer Tools & Observability 🛠️

### Koin Skills — for AI Coding Agents

Official [Koin skills](https://github.com/InsertKoinIO/koin-skills) teach your coding agent to set up Koin, write Koin code, migrate from Hilt, Dagger, Toothpick, Kodein, Metro or older Koin, and diagnose Koin apps, following the Koin Compiler Plugin rules.

```
# Claude Code
/plugin marketplace add InsertKoinIO/koin-skills
/plugin install koin@koin-skills

# Cursor, Codex, Copilot and other agents
npx skills add InsertKoinIO/koin-skills
```

Both commands install from the [koin-skills repository](https://github.com/InsertKoinIO/koin-skills) on GitHub (`npx skills` needs Node.js 22+). See [AI Agents and Koin Skills](https://insert-koin.io/docs/tooling/ai-agents).

### Kotzilla Platform — KMP Crash Reporting & Observability

Free signup on [Kotzilla](https://kotzilla.io)

> The full observability platform for Kotlin Multiplatform apps:
> - **Full KMP Crash Reporting** — complete crash reports across Android, iOS and all KMP targets
> - **Screen Rendering Impact** — understand how each screen affects rendering and user experience
> - **Perfo