rath#

The package-level entrypoint is src/rath/__init__.py. The package root exposes only high-level modules and does not promote all session/backend/flow symbols into the root namespace.

Public contract#

Name

Source

Description

backend

eager import

Backend public API.

flow

eager import

Workflow and agent API.

session

lazy import through __getattr__

Imported on first access to rath.session.

Explicit import style:

from rath import flow
from rath.backend import get
from rath.session import Session, run_session_loop

Autodoc#

OpenRath: sandbox backends, LLM clients, and composable flow.

Sandbox dispatch uses BackendTool. The session loop uses FlowToolCall as the flow-layer tool abstraction.

Import submodules explicitly, e.g. rath.flow.agent_param; rath.session is lazy-loaded via __getattr__().

Persistent configuration (LLM providers, MCP servers) lives in ~/.openrath/config.json — see rath.config. Environment variables (OPENAI_API_KEY etc.) continue to work and take precedence over the config file; OpenRath no longer auto-loads .env, so users wanting that behavior should source it themselves before launching their script.

← API Reference