# oridecon-ai-relay

> AI relay — route and fan-out model calls across providers.

Machine index for **oridecon-ai-relay** only. Rules: https://docs.oridecon.dev/agents.md · Catalog: https://docs.oridecon.dev/llms.txt · Slices: https://docs.oridecon.dev/llms/index.txt · Skill: https://docs.oridecon.dev/SKILL.md

## Package

- Name: `oridecon-ai-relay`
- Group: AI platform — LLMs, RAG, agents, memory, MCP, skills, eval.
- Docs: https://docs.oridecon.dev/platform/oridecon-ai-relay/
- Source (branch `dev`): https://github.com/dbtinoy-/oridecon/tree/dev/experimental/ai/oridecon-ai-relay
- This slice: https://docs.oridecon.dev/llms/oridecon-ai-relay.txt
- Install: `uv add oridecon-ai-relay`

## Boundaries

- Extensions import only `oridecon` and `oridecon-contracts` — never each other.
- Shared types live in `oridecon-contracts`. Do not invent a second copy here.
- Constructor injection. `register()` binds, `boot()` resolves.
- Domain failures are `Result[T, E]`. Infrastructure failures raise.
- One tree: `domains/` (not `models/`), app-root `di/` for `*_provider.py`.

## Docs in this package

- [AI Relay (oridecon-ai-relay)](https://docs.oridecon.dev/platform/oridecon-ai-relay/)
- [API Reference](https://docs.oridecon.dev/platform/oridecon-ai-relay/api/): Complete API reference for the oridecon-ai-relay package.
- [Relay protocol conversion](https://docs.oridecon.dev/platform/oridecon-ai-relay/docs/relay-conversion/): Relay protocol conversion guide and reference for the oridecon-ai-relay package in the Oridecon framework.

## See also

- Playbook: https://docs.oridecon.dev/getting-started/for-coding-agents/
- Fail vs fix: https://docs.oridecon.dev/getting-started/common-mistakes/
- Group hub: https://docs.oridecon.dev/platform/oridecon-ai/
- Skill: https://docs.oridecon.dev/SKILL.md
- Rules (do not skip): https://docs.oridecon.dev/agents.md