Fundamentos de Orionis

Construye tu aplicación con las herramientas de Orionis. Elige lo que necesitas desarrollar para empezar por su guía.

Web y APIs Rutas, controladores, middleware y respuestas HTTP. Realtime y WebSockets Hubs, llamadas tipadas, streaming y grupos. Servidores MCP Tools, recursos y prompts por HTTP o STDIO. Bases de datos y ORM Modelos, relaciones, consultas y migraciones. Autenticación y permisos Sesiones, tokens de API, roles y políticas. Colas y jobs Trabajo en workers con reintentos y control de fallos. Archivos y cloud Uploads y discos locales, S3, Azure o GCS. Vistas y plantillas HTML con Jinja2, layouts y helpers.

También incluye correo caché y locks validación pruebas traducciones.

Construye tu aplicación a partir del esqueleto oficial y añade las funciones que necesite tu proyecto. Para empezar a desarrollar, no necesitas implementar Application, un kernel ni un contenedor: el archivo generado bootstrap/app.py conecta esos componentes.

Tu primera sesión de desarrollo

Instala y crea un proyecto: prepara uv y Git, elige Blank o SSR y crea el entorno de la aplicación.
Arranca la aplicación: ejecuta el servidor desde la raíz del proyecto y comprueba la página de bienvenida.
Configura la aplicación: utiliza .env para los valores de cada entorno y config/ para los ajustes tipados.
Añade tu primera ruta HTTP y elige entre plantillas y una API JSON.
Escribe y ejecuta una prueba antes de incorporar persistencia, autenticación, trabajos en segundo plano, Realtime o MCP.

Los comandos de las guías de aplicación usan uv run python -B reactor ... desde la raíz del proyecto generado. Esta invocación selecciona el entorno de ese proyecto. La invocación independiente uvx --from orionis-installer ... sirve para crear un proyecto nuevo.

Descripción general

Application extiende el Container de inyección y es el objeto exportado desde orionis. Coordina bootstrap, sirve como entrada ASGI/RSGI, despacha CLI, guarda configuración y rutas, carga providers y posee el ciclo de vida.

Foundation también define entidades congeladas para cada subsistema, metadata core inmutable, el servicio de rutas Directory, enums y presentación de startup/shutdown. Las aplicaciones lo configuran en bootstrap/app.py, llaman create() y dejan que servidor HTTP o Reactor dirijan el runtime.

Requisitos

Python 3.14 o posterior; la construcción rechaza intérpretes anteriores.
Raíz de aplicación como str o pathlib.Path.
Módulos de configuración dataclass congelados válidos bajo config.
Archivos de rutas existentes y con la fachada requerida al registrarlos.
Un event loop por worker; el estado mutable no está diseñado para compartirse entre loops o hilos.

Recorrido del módulo

Continúa por: environment · container · http · console.

Instalación y primer proyecto