rodi

What it is and what it does

Rodi implements a dependency injection container that builds an object graph by inspecting type hints and class annotations at runtime, then generates efficient resolver functions to instantiate services on demand. It supports three service lifestyles: singleton (one instance per container), transient (new instance each time), and scoped (one instance per resolution call). The container is designed to be configured once at application startup and left unchanged during normal execution, making it suitable for web frameworks and other long-running applications.

The library operates without requiring changes to existing class source code—it reads constructor signatures and annotations to infer dependencies automatically. It validates the dependency graph when building resolver functions (detecting circular dependencies or missing services upfront), so runtime resolution has minimal overhead. Rodi offers both a generic protocol-based API for swappable DI implementations and a concrete implementation for direct use.

Use it for:

• Bootstrap a web application with centralized service registration and inject dependencies into request handlers
• Build a CLI tool that instantiates command handlers with their required services registered once at startup
• Create a plugin architecture where services are registered dynamically and resolved by type when plugins are loaded
• Manage database connections, loggers, and configuration objects as singletons across an application
• Test application code by registering mock or stub services in place of real implementations

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Rodi is a dependency injection container for Python that resolves and instantiates service dependencies based on type hints, class annotations, or configured names, supporting singleton, transient, and scoped lifestyles.

Yes. Rodi is actively maintained, has no external dependencies, supports modern Python versions (3.10+), carries a permissive MIT license, and solves a real problem for applications that need structured dependency management. It is particularly valuable in web frameworks and larger applications where service lifecycle management matters. No known security vulnerabilities.

Install

rodi on PyPI

pip install rodi

uv add rodi

poetry add rodi

Installing rodi

Before you install

Low friction install with no runtime dependencies. Active maintenance as of 2026-03-08 with 239 repository stars. Supports Python 3.10 through 3.14.

License in practice

MIT License permits unrestricted use, modification, and distribution with minimal restrictions—suitable for commercial and proprietary projects.

Quickstart

pip install rodi

from rodi import Container

container = Container()
container.register(MyService)
service = container.resolve(MyService)

Requires Python 3.10 or later.

Verify before relying

• Whether type resolution handles forward references and string annotations correctly
• Performance characteristics when resolving deeply nested dependency graphs
• Compatibility with async/await patterns in service initialization

Package facts

Evidence: rodi-2.1.0-py3-none-any.whl

Keywords: dependency, hints, injection, type, typing

Tags

More Application Frameworks packages