Orionis Framework
Write Python. Build the whole application.
Async-first Python framework for web applications and APIs.
Documentation • Repositories • Website
About Orionis
Orionis is an open-source, async-first Python framework for building web applications and APIs. This repository contains the framework core. To start a new application, visit the Orionis Skeleton repository.
Learning Orionis
Visit the official documentation for guides and reference material. You can also explore the project website or find the package on PyPI.
Installation
Install the framework with uv add orionis. Faker and SQLite support are included.
Use uv add 'orionis[pgsql]' for PostgreSQL (async and synchronous drivers), or
uv add 'orionis[database]' for all optional database drivers. Cloud storage
SDKs and other database backends remain optional; see pyproject.toml for extras.
Application CLI
From the application root, run commands through the installed orionis entry
point:
uv sync
uv run orionis serve
With the project's virtual environment activated, run orionis serve directly.
The entry point loads the project's bootstrap.app and runs commands in the
same process with bytecode writes disabled; it does not require a reactor
script. Command arguments and exit codes are preserved. The legacy command
python -B reactor serve remains available.
Native MCP servers
Expose application services through MCP 2026-07-28 using the existing Orionis container, schemas, authentication and HTTP pipeline. The same server declaration supports Streamable HTTP through ASGI/RSGI and local STDIO:
# routes/ai.py
from orionis.mcp import McpResponse, Server, Tool
from orionis.support.facades.mcp import Mcp
class StatusTool(Tool):
async def handle(self) -> McpResponse:
return McpResponse.text("ready")
class StatusServer(Server):
name = "Status"
tools = (StatusTool,)
Mcp.web("/mcp/status", StatusServer)
Mcp.local("status", StatusServer)
Configure app.withRouting(ai="routes/ai.py") before app.create(). Start the
local server with python reactor mcp:start status. Every request declares its
version and capabilities; no initialization session is required.
Read the MCP guide or guía en español for typed tools, resources, prompts, HTTP headers, security, subscriptions and verification commands.
Repositories
- Framework Core — source code for the framework.
- Application Skeleton — starting point for Orionis applications.
- Documentation — source for the documentation website.
- CLI Installer — command-line installer.
- Website — source for the project website.
- Inertia Adapter — Orionis integration for Inertia.js.
Contributing
API documentation uses [tool.pydoctor]. Pydoctor reads that table, not PEP 621
metadata, so the display name and link URLs must remain explicit. DOCS.ps1
already reads the version from [project] and supplies the Git revision through
supported CLI options; no metadata synchronization layer is needed. See the
official configuration reference.
Contributions and feedback are welcome. Report bugs or request features in GitHub Issues, or join the conversation in GitHub Discussions.
Sponsors
Creator
Created and maintained by Raul Mauricio Uñate Castro.
Orionis is open-source software released under the MIT license.
1 maintainer
Metadata
1 maintainer
Release files for orionis 0.810.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| orionis-0.810.0.tar.gz | 1.5 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| orionis-0.810.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 3.5 MB
Release files / orionis-0.810.0.tar.gz
| Download URL | orionis-0.810.0.tar.gz |
|---|---|
| Size | 1.5 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
98d200b1d80f4cc5edb334b7f8232a4527116b135c510f0f45bdfe3f1e6a69c8
|
|
BLAKE2b-256 checksum How to use checksums |
ddafffedae44366077b42ce7e8cc700c8261d7af73487ad1335fed7a69100522
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.30 {"installer":{"name":"uv","version":"0.11.30","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / orionis-0.810.0-py3-none-any.whl
| Download URL | orionis-0.810.0-py3-none-any.whl |
|---|---|
| Size | 2.0 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
54e212490605d49656a1c470fab7eedcb1d5a3ef604f5887440a4f6bf0972563
|
|
BLAKE2b-256 checksum How to use checksums |
15d3387d2cffffbad474bff1095d814404fd1dcf1d81ba5c3573dd544c1cdd08
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.30 {"installer":{"name":"uv","version":"0.11.30","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
