elric-core 0.1.0

Runtime core for the Elric framework: settings, providers, middleware, routing and AI base classes

elric-core

Runtime core of the Elric framework.

elric-core is a runtime dependency of every generated Elric project. It holds the code the framework owns and keeps upgrading for you: settings, providers, middleware, route discovery, error handling, and the AI component base classes.

Code that elric new copies into your project belongs to you and is never touched by an upgrade. Anything the framework must be able to change later lives here instead.

Installation

You normally get it via the project scaffold:

uv tool install elric-cli
elric new my_app

Standalone:

uv add elric-core

Usage

# config/settings.py
from functools import lru_cache
from elric_core import ElricSettings


class Settings(ElricSettings):
    """Project settings. Add your own fields here."""


@lru_cache
def get_settings() -> Settings:
    return Settings()

# app/__init__.py
from pathlib import Path

from elric_core import create_application
from config.settings import get_settings

ROUTES_DIR = Path(__file__).resolve().parent / "routes"


def create_app():
    return create_application(get_settings(), routes_dir=ROUTES_DIR)

create_application wires the lifespan (database, Redis, LangSmith), the middleware stack, the global exception handler, and auto-discovers every module under routes_dir that exposes a module-level router.

What's inside

Module	Contents
elric_core.config	ElricSettings base class + settings registry
elric_core.logging	structlog setup, trace-id context
elric_core.providers	async SQLAlchemy engine, Redis, LangSmith
elric_core.middleware	API key auth, sliding-window rate limit, request logging
elric_core.routing	filesystem route auto-discovery
elric_core.exceptions	exception hierarchy + uniform JSON error handler
elric_core.security	API key generation, hashing, verification
elric_core.models	framework SQLModel tables (ApiKey)
elric_core.ai	BaseAgent, BaseChain, BaseTool

Schema ownership

elric-core never creates tables. Alembic owns the schema — run elric migrate. init_db() only verifies connectivity at startup.

License

MIT