THE ORIONIS API
Build with clarity.
Explore the building blocks of an async-first Python framework. Every module, class, and method — connected, searchable, and ready to build with.
Bound MCP work and explicitly allow trusted HTTP browser origins.
Read environment defaults when each instance is created. Explicit constructor values take precedence and supplied lists or tuples are copied to independent lists.
An absent Origin is accepted by the transport. An empty allowed_origins rejects every present Origin; there is no wildcard or implicit same-origin exception. Each allowed entry is a serialized HTTP(S) origin. Defaults come directly from the shared CORS_ALLOW_ORIGINS environment variable.
| Method | __post |
Reject coercion, unbounded budgets, and ambiguous origin allowlists. |
| Instance Variable | allowed |
Explicit trusted HTTP(S) browser origins without wildcards. Read CORS_ALLOW_ORIGINS with a default of an empty list. |
| Instance Variable | default |
Default number of entries returned by paginated list operations. Read MCP_DEFAULT_PAGE_SIZE with a default of 50. |
| Instance Variable | max |
Maximum concurrent MCP requests. Read MCP_MAX_CONCURRENT_REQUESTS, then HTTP_MAX_CONCURRENT_REQUESTS, with a final default of 32. |
| Instance Variable | max |
Maximum serialized request or response metadata size in bytes. Read MCP_MAX_METADATA_SIZE with a default of 64 KiB. |
| Instance Variable | max |
Maximum entries per page; must be at least default_page_size. Read MCP_MAX_PAGE_SIZE with a default of 100. |
| Instance Variable | max |
Maximum serialized request size in bytes. Read MCP_MAX_REQUEST_SIZE, then HTTP_MAX_BODY_SIZE, with a final default of 1 MiB. |
| Instance Variable | max |
Maximum resource subscriptions per request or client context. Read MCP_MAX_RESOURCE_SUBSCRIPTIONS with a default of 64. |
| Instance Variable | max |
Maximum serialized response size in bytes. Read MCP_MAX_RESPONSE_SIZE with a default of 4 MiB. |
| Instance Variable | max |
Maximum total event-bus subscriptions. Read MCP_MAX_SUBSCRIPTIONS with a default of 1024. |
| Instance Variable | subscription |
Maximum buffered events per subscription. Read MCP_SUBSCRIPTION_BUFFER_SIZE with a default of 64. |
| Instance Variable | subscription |
Finite positive interval in seconds between subscription keepalive messages. Read MCP_SUBSCRIPTION_KEEPALIVE with a default of 15.0. |
| Instance Variable | tool |
Maximum tool calls allowed in one catalog execution. Read MCP_TOOL_SEARCH_MAX_CALLS with a default of 5. |
| Instance Variable | tool |
Maximum serialized tool catalog output size in bytes. Read MCP_TOOL_SEARCH_MAX_OUTPUT_BYTES with a default of 256 KiB. |
| Instance Variable | tool |
Maximum results returned by a tool catalog search. Read MCP_TOOL_SEARCH_MAX_RESULTS with a default of 20. |
Inherited from BaseEntity:
| Class Method | _cached |
Retrieve field definitions and normalized types cached by class. |
| Method | __init__ |
Initialize declared fields and public extra attributes. |
| Method | _dynamic |
Return public instance attributes that are not declared fields. |
| Method | _validate |
Validate names and storage for public extra attributes. |
| Method | get |
Describe declared fields and, optionally, dynamic attributes. |
| Method | to |
Return a recursively copied dictionary of declared and extra values. |
| Class Variable | __slots__ |
Declare that this class introduces no additional instance slots. |
| Class Variable | _orionis |
Cache declared fields and normalized type names for each concrete class. |
Reject coercion, unbounded budgets, and ambiguous origin allowlists.
| Returns | |
None | Retain validated configuration with independently copied origin lists. |
| Raises | |
TypeError | If a budget, duration, or origin has an incompatible type. |
ValueError | If a budget or duration is invalid, or an origin is malformed. |
Explicit trusted HTTP(S) browser origins without wildcards. Read CORS_ALLOW_ORIGINS with a default of an empty list.
Default number of entries returned by paginated list operations. Read MCP_DEFAULT_PAGE_SIZE with a default of 50.
Maximum concurrent MCP requests. Read MCP_MAX_CONCURRENT_REQUESTS, then HTTP_MAX_CONCURRENT_REQUESTS, with a final default of 32.
Maximum serialized request or response metadata size in bytes. Read MCP_MAX_METADATA_SIZE with a default of 64 KiB.
Maximum entries per page; must be at least default_page_size. Read MCP_MAX_PAGE_SIZE with a default of 100.
Maximum serialized request size in bytes. Read MCP_MAX_REQUEST_SIZE, then HTTP_MAX_BODY_SIZE, with a final default of 1 MiB.
Maximum resource subscriptions per request or client context. Read MCP_MAX_RESOURCE_SUBSCRIPTIONS with a default of 64.
Finite positive interval in seconds between subscription keepalive messages. Read MCP_SUBSCRIPTION_KEEPALIVE with a default of 15.0.
Maximum tool calls allowed in one catalog execution. Read MCP_TOOL_SEARCH_MAX_CALLS with a default of 5.