Mock B — Anthropic editorial style, blue palette (cobalt #1E40AF). Serif headlines, warm off-white background, dark code blocks.
LazyBridge
View on GitHub
Get started

Build LLM agents the lazy way.

LazyBridge is a zero-boilerplate, multi-provider Python framework. One Agent class, swappable engines, and one tool contract — everything is a tool.

Python Copy
from lazybridge import Agent, LLMEngine

agent = Agent(
    engine=LLMEngine("claude-opus-4-7"),
)
result = agent("hello")
print(result.text())

That's the whole surface when you start — it grows only when your problem grows. Parallelism is automatic when the engine emits multiple tool calls in a turn; deterministic when you declare it.

Status — alpha (0.7.x)

API is intentionally fluid pre-1.0. Pin a minor (lazybridge>=0.7,<0.8) in production until 1.0.

The mental model

Every Agent is the composition Engine + Tools + State. The same shape supports a one-shot helper, a hierarchical multi-agent system, and a checkpointed production pipeline — only the engine= argument changes.

Pick your tier

Every tier is additive. Lift the lid only when the problem requires it.

Basic

One-shot, tool-calling agents

Agent · LLMEngine · Tool · NativeTool · Envelope

Mid

Real apps with state & control

Memory · Store · Session · Guard* · verify= · MCP

Full

Production pipelines

Plan · Step · sentinels · SupervisorEngine · checkpoint

Advanced

Extend the framework

BaseProvider · custom engines · OpenTelemetry · Visualizer

Function becomes a tool

No decorators. No hand-written JSON schemas. Type hints and the docstring become the tool's LLM-facing schema automatically.

Python Copy
from lazybridge import Agent, LLMEngine, Tool


def get_weather(city: str) -> str:
    """Return current temperature and conditions for ``city``."""
    return f"{city}: 22°C, sunny"


agent = Agent(
    engine=LLMEngine("claude-opus-4-7"),
    tools=[Tool.wrap(get_weather, name="get_weather")],
)
result = agent("what's the weather in Rome and Paris?")
print(result.text())

Core primitives

SymbolWhat it is
LLMEngineAn LLM call loop. Tool-aware, optionally streaming, retries on transient errors.
PlanDeterministic DAG of Steps. Validates at construction, resumes on crash.
Tool.wrap(fn)Lift any Python callable into a tool. Schema inferred from type hints.
MCP.stdio / MCP.httpMount an MCP server as a tool catalogue. Deny-by-default since 0.7.9.
Memory · Store · SessionIn-prompt history, durable blackboard, and event bus + observability.