# Oridecon > Oridecon is an async-first, contract-driven Python framework for coding agents. Protocols, a typed DI container, 17 AI packages, and a full backend — web, SQL, auth, queues. Oridecon is alpha (0.1.x), public release 0.1.1, MIT licensed, Python 3.11+. Prefer protocols over concrete classes. Pin `>=0.1,<0.2`. Extensions depend only on `oridecon` and `oridecon-contracts`, never on each other. # Per-package LLM indexes One file per package so a SQL or RAG task does not load the whole catalog. Rules: https://docs.oridecon.dev/agents.md · Full index: https://docs.oridecon.dev/llms.txt ## Foundation - [oridecon](https://docs.oridecon.dev/llms/oridecon.txt) — Async-first DI container, Application lifecycle, modules, providers, config, and the Result type. - [oridecon-contracts](https://docs.oridecon.dev/llms/oridecon-contracts.txt) — Zero-dependency protocols, value types, and exceptions shared across every package. ## Web & HTTP - [oridecon-web](https://docs.oridecon.dev/llms/oridecon-web.txt) — ASGI web layer — controllers, routing, middleware, OpenAPI, CORS, CSRF, rate limiting. - [oridecon-http](https://docs.oridecon.dev/llms/oridecon-http.txt) — Outbound HTTP client with resilience and observability built in. - [oridecon-graphql](https://docs.oridecon.dev/llms/oridecon-graphql.txt) — GraphQL server (Strawberry) — schema, subscriptions, depth/complexity limits, persisted queries. - [oridecon-webhook](https://docs.oridecon.dev/llms/oridecon-webhook.txt) — Webhook management — subscriptions, delivery tracking, HMAC verification, dead-letter queue. ## Data - [oridecon-sql](https://docs.oridecon.dev/llms/oridecon-sql.txt) — Async SQL for Postgres / MySQL / SQLite — repositories, migrations, query building. - [oridecon-nosql](https://docs.oridecon.dev/llms/oridecon-nosql.txt) — Document-store abstraction (MongoDB, DynamoDB, Firestore). - [oridecon-cache](https://docs.oridecon.dev/llms/oridecon-cache.txt) — Multi-backend caching — Redis, Memcached, in-memory — behind CacheBackendProtocol. - [oridecon-storage](https://docs.oridecon.dev/llms/oridecon-storage.txt) — Unified blob storage — S3, GCS, Azure Blob, R2, local filesystem. - [oridecon-search](https://docs.oridecon.dev/llms/oridecon-search.txt) — Full-text search — Elasticsearch, Meilisearch, Typesense, and SQL backends. ## Security - [oridecon-auth](https://docs.oridecon.dev/llms/oridecon-auth.txt) — Authentication and authorization — JWT, OAuth2, RBAC, password hashing, web guards. - [oridecon-secrets](https://docs.oridecon.dev/llms/oridecon-secrets.txt) — Secret vaults with rotation, tenant scoping, and audit. ## Events - [oridecon-events](https://docs.oridecon.dev/llms/oridecon-events.txt) — Event sourcing and CQRS — domain events, aggregates, command/query buses, projections. - [oridecon-queue](https://docs.oridecon.dev/llms/oridecon-queue.txt) — Message bus / queue with named multi-backend support (Redis, RabbitMQ, Kafka, SQS). - [oridecon-notification](https://docs.oridecon.dev/llms/oridecon-notification.txt) — Email, SMS, and push delivery with multi-backend support. ## Infrastructure - [oridecon-tasks](https://docs.oridecon.dev/llms/oridecon-tasks.txt) — Background tasks — scheduling, workers, and job queues over memory / Redis / AMQP / Postgres. - [oridecon-workflow](https://docs.oridecon.dev/llms/oridecon-workflow.txt) — Workflow orchestration — pipelines, bulk ops, sagas, graph engine. - [oridecon-tenancy](https://docs.oridecon.dev/llms/oridecon-tenancy.txt) — Multi-tenant resolution, lifecycle, and isolation strategies. - [oridecon-resilience](https://docs.oridecon.dev/llms/oridecon-resilience.txt) — Circuit breaker, retry, bulkhead, rate limiting, throttle, fallback. - [oridecon-monitor](https://docs.oridecon.dev/llms/oridecon-monitor.txt) — Health checks, metrics, tracing, and structured logging (Prometheus / OpenTelemetry). - [oridecon-audit](https://docs.oridecon.dev/llms/oridecon-audit.txt) — Append-only, HMAC-verified, retention-managed audit trail. - [oridecon-vector](https://docs.oridecon.dev/llms/oridecon-vector.txt) — Vector store backends (pgvector, Qdrant, Pinecone, in-memory) for embeddings. - [oridecon-graph](https://docs.oridecon.dev/llms/oridecon-graph.txt) — Graph database support (Neo4j, in-memory). - [oridecon-features](https://docs.oridecon.dev/llms/oridecon-features.txt) — Feature-flag management with caching and pluggable providers. ## AI platform - [oridecon-ai](https://docs.oridecon.dev/llms/oridecon-ai.txt) — Orchestration layer that discovers and wires the AI subsystems below. - [oridecon-ai-llm](https://docs.oridecon.dev/llms/oridecon-ai-llm.txt) — Multi-provider LLM client with routing and thinking suppression. - [oridecon-ai-rag](https://docs.oridecon.dev/llms/oridecon-ai-rag.txt) — Retrieval-augmented generation — chunking, retrieval, synthesis, citations. - [oridecon-ai-agents](https://docs.oridecon.dev/llms/oridecon-ai-agents.txt) — Agents with tools and strategies (ReAct, plan-and-execute). - [oridecon-ai-memory](https://docs.oridecon.dev/llms/oridecon-ai-memory.txt) — Episodic, semantic, and working memory for AI systems. - [oridecon-ai-skills](https://docs.oridecon.dev/llms/oridecon-ai-skills.txt) — Skill/tool registry, executor, and built-in tools. - [oridecon-ai-session](https://docs.oridecon.dev/llms/oridecon-ai-session.txt) — AI conversation sessions — branching, checkpointing, multi-agent. - [oridecon-ai-mcp](https://docs.oridecon.dev/llms/oridecon-ai-mcp.txt) — Model Context Protocol server and client for AI agents. - [oridecon-ai-workers](https://docs.oridecon.dev/llms/oridecon-ai-workers.txt) — Background AI work — batch embedding, document ingestion, maintenance. - [oridecon-ai-feedback](https://docs.oridecon.dev/llms/oridecon-ai-feedback.txt) — Collect, process, and store feedback on AI responses. - [oridecon-ai-guard](https://docs.oridecon.dev/llms/oridecon-ai-guard.txt) — Input/output guard pipeline — LLM safety and content filtering. - [oridecon-ai-governance](https://docs.oridecon.dev/llms/oridecon-ai-governance.txt) — AI governance — policy enforcement, audit trails, budget tracking. - [oridecon-ai-evaluation](https://docs.oridecon.dev/llms/oridecon-ai-evaluation.txt) — Evaluation framework — benchmarks and quality gates for AI outputs. - [oridecon-ai-prompt](https://docs.oridecon.dev/llms/oridecon-ai-prompt.txt) — Prompt management — templates, composition, optimization. - [oridecon-ai-observability](https://docs.oridecon.dev/llms/oridecon-ai-observability.txt) — Tracing, metrics, and health checks specific to AI calls. - [oridecon-ai-relay](https://docs.oridecon.dev/llms/oridecon-ai-relay.txt) — AI relay — route and fan-out model calls across providers. - [oridecon-ai-relay-gateway](https://docs.oridecon.dev/llms/oridecon-ai-relay-gateway.txt) — Gateway for the AI relay — ingress, auth, and quota at the edge. ## Multimedia - [oridecon-multimedia](https://docs.oridecon.dev/llms/oridecon-multimedia.txt) — Orchestration layer for multimedia generation packages. - [oridecon-multimedia-image](https://docs.oridecon.dev/llms/oridecon-multimedia-image.txt) — Image generation backends. - [oridecon-multimedia-video](https://docs.oridecon.dev/llms/oridecon-multimedia-video.txt) — Video generation backends. - [oridecon-multimedia-tts](https://docs.oridecon.dev/llms/oridecon-multimedia-tts.txt) — Text-to-speech backends. - [oridecon-multimedia-music](https://docs.oridecon.dev/llms/oridecon-multimedia-music.txt) — Music generation backends. - [oridecon-multimedia-beat](https://docs.oridecon.dev/llms/oridecon-multimedia-beat.txt) — Beat / rhythm generation backends. - [oridecon-multimedia-upscale](https://docs.oridecon.dev/llms/oridecon-multimedia-upscale.txt) — Image and video upscaling backends. - [oridecon-multimedia-interpolate](https://docs.oridecon.dev/llms/oridecon-multimedia-interpolate.txt) — Frame interpolation backends. ## Tooling - [oridecon-testing](https://docs.oridecon.dev/llms/oridecon-testing.txt) — Fakes, test clients/beds, fixed clock, and protocol compliance suites. - [oridecon-cli](https://docs.oridecon.dev/llms/oridecon-cli.txt) — oridecon command — project scaffolding, dev server, migrations, inspection. - [oridecon-admin](https://docs.oridecon.dev/llms/oridecon-admin.txt) — Admin panel — CRUD, dashboards, RBAC. - [oridecon-ui](https://docs.oridecon.dev/llms/oridecon-ui.txt) — HTMX/htpy component library.