跳转至

lovia

lovia 是一个轻量的 Python Agent 框架。先用一个 Agent 和几行 Python 跑起来；需要时再加入 Tool、流式事件、持久化、Workspace 或 Web UI。

pip install lovia

先在快速开始：配置模型中设置端点，再把下面的 <model> 换成端点提供的模型名。

from lovia import Agent

agent = Agent(
    name="assistant",
    instructions="用清楚、具体的语言回答。",
    model="<model>",
)

print(agent.run_sync("天空为什么是蓝色的？").output)

完成首次运行 → 打开 Web UI →

从你的目标开始

我想要… 先看 再深入
跑通第一个 Agent 快速开始 核心概念
接入模型或网关 配置模型 Provider 与模型
让模型调用代码 工具 内置工具
读取文件、执行命令 工作区 工具审批
保存对话或恢复任务 Session 与 Checkpoint 上下文管理
组合多个 Agent 多 Agent 插件
做成聊天应用 Web UI Web 服务端 · HTTP API
测试 Agent 行为 测试 评测 · 可观测性

lovia 的取舍

  • 核心只依赖 httpx、pydantic 和 pyyaml，其他集成按需安装。
  • Agent 只保存配置；每次 Run 的可变状态由运行循环管理。
  • 上下文压缩只改变模型 View，不改写本次 Run 的 Transcript；超大 Tool 输出仍受配置上限约束。
  • Skills、MCP、Todo、Memory 和自定义能力共用 Plugin 扩展点。

用示例学习

示例按难度排列，每个文件都可以单独运行：

版本说明

本站对应 main 分支，可能比已安装的版本更新。运行 python -c "import lovia; print(lovia.__version__)" 可以查看本地版本。

修改框架本身时，请先阅读架构说明。

English documentation: docs/en.