---
id: alluka
version: "0.4.0"
license: unclear
license_treatment: permissive
maintenance: aging
---

# alluka — A type based dependency injection framework for Python 3.9+.

License: permissive · Maintenance: aging · Downloads: 73.8K/mo

## What it is and what it does

Alluka is a dependency injection container that leverages Python's type system to automatically wire dependencies. Instead of manually passing arguments through function calls, you declare what your functions need via type hints, and Alluka resolves and injects those dependencies at runtime. It supports both synchronous and asynchronous code through integrations with AsyncIO and Trio.

The framework is designed for developers building applications where dependency management becomes complex—microservices, plugin systems, or large codebases where loose coupling matters. It's currently in Beta and requires Python 3.11 or later, with a minimal dependency footprint (only typing-extensions at runtime).

Use it for:

- Building microservices where multiple components need shared resources like database connections or configuration objects
- Creating plugin architectures where plugins declare their dependencies and the framework wires them automatically
- Testing applications by injecting mock implementations of services without changing production code
- Async applications using AsyncIO or Trio that need clean dependency management across concurrent tasks
- Large codebases where explicit dependency passing becomes unwieldy and a central container improves maintainability

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Alluka is a type-based dependency injection framework that uses Python's type hints to automatically resolve and inject dependencies into functions and classes.

Yes, if you're building a Python 3.11+ application where dependency injection would reduce coupling and improve testability. The low install friction, permissive license, and zero known vulnerabilities make it safe to adopt. However, the aging maintenance status (628 days since last release) means you should verify that the framework's feature set meets your needs before committing—it's stable but not under active development.

## Install

pip install alluka
uv add alluka
poetry add alluka

## Installing alluka

Before you install: Installation is straightforward with low friction—a single pure-Python wheel with only typing-extensions as a runtime dependency. The package is in Beta status and has not been updated in 628 days, suggesting stable but not actively developed code.

License in practice: Licensed under BSD (permissive), which allows commercial and private use with minimal restrictions.

Quickstart:

pip install alluka

from alluka import Injector

injector = Injector()
result = injector.call(your_function)

Requires Python 3.11 or above; the framework is designed for Python 3.11+.

Verify before relying:

- Whether the framework supports async/await patterns beyond the AsyncIO and Trio classifiers suggest
- Performance characteristics and overhead compared to manual dependency passing
- Real-world adoption patterns and community examples beyond the official documentation

## Package facts

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 73.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

dependency injection framework, type-based DI Python, automatic dependency resolution, Python DI container, type hint injection, async dependency injection, service locator pattern, dependency-injection, type-hints, async-support

[View on SkillFed](https://skillfed.io/packages/alluka) · [View on PyPI](https://pypi.org/project/alluka/)