Skip to content
Packages Examples Agents Blog Get started

Packages

54 packages, all MIT, all alpha (0.1.x). The two foundation packages — oridecon and oridecon-contracts — are all you need to start. Everything else is an extension: install only what the app uses.

Every extension depends only on oridecon and oridecon-contracts, never on another extension.

oridecon-contracts → Zero dependencies (protocols, types, exceptions)
oridecon → Application, container, providers, modules, Result, YAML config
oridecon-* → Extensions (web, SQL, auth, AI, …)

Start from the CLI. Templates pick the first handful of packages; you add the rest later.

Terminal window
uv add oridecon-cli
oridecon new project my-app --template web-api
oridecon run

This catalog is the same list as The Ecosystem and the sidebar. Canonical URLs live under /packages/{group}/…, /platform/…, and /experimental/…. Ungrouped /packages/oridecon-* paths redirect here.

Foundation

Application, container, providers, modules, config, Result.

PackageWhat it does
orideconAsync-first DI container, Application lifecycle, modules, providers, config, and the Result type.
oridecon-contractsZero-dependency protocols, value types, and exceptions shared across every package.

Web & HTTP

ASGI, GraphQL, outbound HTTP, webhooks.

PackageWhat it does
oridecon-webASGI web layer — controllers, routing, middleware, OpenAPI, CORS, CSRF, rate limiting.
oridecon-httpOutbound HTTP client with resilience and observability built in.
oridecon-graphqlGraphQL server (Strawberry) — schema, subscriptions, depth/complexity limits, persisted queries.
oridecon-webhookWebhook management — subscriptions, delivery tracking, HMAC verification, dead-letter queue.

Data

SQL, NoSQL, cache, object storage, search.

PackageWhat it does
oridecon-sqlAsync SQL for Postgres / MySQL / SQLite — repositories, migrations, query building.
oridecon-nosqlDocument-store abstraction (MongoDB, DynamoDB, Firestore).
oridecon-cacheMulti-backend caching — Redis, Memcached, in-memory — behind CacheBackendProtocol.
oridecon-storageUnified blob storage — S3, GCS, Azure Blob, R2, local filesystem.
oridecon-searchFull-text search — Elasticsearch, Meilisearch, Typesense, and SQL backends.

Security

Auth, secrets, JWT, OAuth2, guards.

PackageWhat it does
oridecon-authAuthentication and authorization — JWT, OAuth2, RBAC, password hashing, web guards.
oridecon-secretsSecret vaults with rotation, tenant scoping, and audit.

Events

Domain events, queues, notifications.

PackageWhat it does
oridecon-eventsEvent sourcing and CQRS — domain events, aggregates, command/query buses, projections.
oridecon-queueMessage bus / queue with named multi-backend support (Redis, RabbitMQ, Kafka, SQS).
oridecon-notificationEmail, SMS, and push delivery with multi-backend support.

Infrastructure

Tasks, workflows, tenancy, resilience, vectors.

PackageWhat it does
oridecon-tasksBackground tasks — scheduling, workers, and job queues over memory / Redis / AMQP / Postgres.
oridecon-workflowWorkflow orchestration — pipelines, bulk ops, sagas, graph engine.
oridecon-tenancyMulti-tenant resolution, lifecycle, and isolation strategies.
oridecon-resilienceCircuit breaker, retry, bulkhead, rate limiting, throttle, fallback.
oridecon-monitorHealth checks, metrics, tracing, and structured logging (Prometheus / OpenTelemetry).
oridecon-auditAppend-only, HMAC-verified, retention-managed audit trail.
oridecon-vectorVector store backends (pgvector, Qdrant, Pinecone, in-memory) for embeddings.
oridecon-graphGraph database support (Neo4j, in-memory).
oridecon-featuresFeature-flag management with caching and pluggable providers.

AI platform

LLMs, RAG, agents, memory, MCP, skills, eval.

PackageWhat it does
oridecon-aiOrchestration layer that discovers and wires the AI subsystems below.
oridecon-ai-llmMulti-provider LLM client with routing and thinking suppression.
oridecon-ai-ragRetrieval-augmented generation — chunking, retrieval, synthesis, citations.
oridecon-ai-agentsAgents with tools and strategies (ReAct, plan-and-execute).
oridecon-ai-memoryEpisodic, semantic, and working memory for AI systems.
oridecon-ai-skillsSkill/tool registry, executor, and built-in tools.
oridecon-ai-sessionAI conversation sessions — branching, checkpointing, multi-agent.
oridecon-ai-mcpModel Context Protocol server and client for AI agents.
oridecon-ai-workersBackground AI work — batch embedding, document ingestion, maintenance.
oridecon-ai-feedbackCollect, process, and store feedback on AI responses.
oridecon-ai-guardInput/output guard pipeline — LLM safety and content filtering.
oridecon-ai-governanceAI governance — policy enforcement, audit trails, budget tracking.
oridecon-ai-evaluationEvaluation framework — benchmarks and quality gates for AI outputs.
oridecon-ai-promptPrompt management — templates, composition, optimization.
oridecon-ai-observabilityTracing, metrics, and health checks specific to AI calls.
oridecon-ai-relayAI relay — route and fan-out model calls across providers.
oridecon-ai-relay-gatewayGateway for the AI relay — ingress, auth, and quota at the edge.

Multimedia

Image, video, audio, TTS, upscale, interpolate.

PackageWhat it does
oridecon-multimediaOrchestration layer for multimedia generation packages.
oridecon-multimedia-imageImage generation backends.
oridecon-multimedia-videoVideo generation backends.
oridecon-multimedia-ttsText-to-speech backends.
oridecon-multimedia-musicMusic generation backends.
oridecon-multimedia-beatBeat / rhythm generation backends.
oridecon-multimedia-upscaleImage and video upscaling backends.
oridecon-multimedia-interpolateFrame interpolation backends.

Tooling

CLI, testing, admin, UI — experimental except testing.

PackageWhat it does
oridecon-testingFakes, test clients/beds, fixed clock, and protocol compliance suites.
oridecon-clioridecon command — project scaffolding, dev server, migrations, inspection.
oridecon-adminAdmin panel — CRUD, dashboards, RBAC.
oridecon-uiHTMX/htpy component library.