codex-platform 0.5.0

Modular async infrastructure (Redis, Streams, ARQ, Notifications) built for Codex, designed for independent use.

codex-platform

codex-platform is a modular, async infrastructure library. Originally built as the foundation for the Codex ecosystem, it is designed from the ground up to be completely independent. You can use it in any Python project to get a typed Redis abstraction, a Redis Streams event bus, structured ARQ background workers, or a multi-channel notification engine. Every component is completely independent and can be installed as a separate extra.

---

Install

# codex-platform 0.3.x
pip install "codex-platform>=0.3.0,<0.4.0"

# With Redis support
pip install "codex-platform[redis]>=0.3.0,<0.4.0"

# With ARQ background workers
pip install "codex-platform[arq]>=0.3.0,<0.4.0"

# With async SMTP notifications
pip install "codex-platform[notifications]>=0.3.0,<0.4.0"

# Redis Streams
pip install "codex-platform[streams]>=0.3.0,<0.4.0"

# Everything
pip install "codex-platform[all]>=0.3.0,<0.4.0"

Requires Python 3.12 or newer. Installs codex-core>=0.3.0,<0.10.0 automatically as a dependency.

Development

uv sync --extra dev
uv run pytest
uv run mypy src/
uv run pre-commit run --all-files
uv build --no-sources

Quick Start

from redis.asyncio import Redis
from codex_platform.redis_service import RedisService

redis = Redis(host="localhost", port=6379)
service = RedisService(redis)

await service.hash.set_json("user:42", "profile", {"name": "Alex"})
data = await service.hash.get_json("user:42", "profile")

Modules

Module	Extra	Description
redis_service	[redis]	Typed async Redis abstraction — Hash, String, List, Set, ZSet, JSON, Pipeline
streams	[streams]	Redis Streams producer/consumer with consumer groups, retry, and DLQ
workers.arq	[arq]	ARQ worker base infrastructure — health probes, DLQ retry, CORE_FUNCTIONS
notifications	[notifications]	Multi-channel notification engine — SMTP, ARQ/Direct delivery, Jinja2 renderer

Documentation

Full docs with architecture, API reference, and data flow diagrams:

codexdlc.github.io/codex-platform

Part of the Codex ecosystem

Package	Role
codex-core	Foundation — immutable DTOs, PII masking, env settings
codex-platform	Infrastructure — Redis, Streams, ARQ workers, Notifications
codex-ai	LLM layer — unified async interface for OpenAI, Gemini, Anthropic
codex-services	Business logic — Booking engine, CRM, Calendar

Each library is fully standalone — install only what your project needs. Together they form the backbone of codex-bot (Telegram AI-agent infrastructure built on aiogram) and codex-django (Django integration layer).