rigging

用 pydantic 强类型约束 LLM 输出,少写胶水代码

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 开发框架 🍴 复刻 39 🐛 待处理 9 👀 关注 11
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 426
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 开源免费,文档站提供使用说明

项目预览

rigging 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类开发框架
开发团队dreadnode
定价模式🏷️完全免费
价格说明开源免费,文档站提供使用说明
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言Python
技术栈/模型agents,litellm,llms,pydantic
GitHub 星标★ 426
上线时间2024-01-29 00:00:00
代码更新2026-11-18
仓库体积22.5 MB
本站数据更新2026-11-21
维护状态活跃
收录时间2026-10-07
浏览次数3

项目介绍

rigging 是一个轻量级 LLM 交互框架,基于 Python 和 pydantic 构建,底层通过 litellm 统一对接多家模型服务。它要解决的问题是:直接调用各家 LLM API 时,参数格式、返回结构、流式处理和工具调用方式各不相同,导致业务代码被供应商细节污染。rigging 用 pydantic 模型把输入输出强类型化,让开发者用声明式方式定义提示、结构化输出和工具调用,框架负责解析、校验与重试。核心能力包括:统一的多模型调用接口、基于 pydantic 的结构化输出解析、函数/工具调用编排、流式响应处理,以及面向 agent 场景的轻量封装。它不追求大而全的编排平台,而是把 LLM 交互这一层做薄,方便嵌入已有 Python 项目。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-10-07 · 当前星标 ★ 426

技术标签

使用教程

难度:入门 约 20 分钟 部署方式:本地安装 4 步

环境要求

  • Python 3.10+
  • 一个模型 API Key

安装与启动步骤

  1. 1装包

    库与命令行一起装。

    pip install rigging
  2. 2配一个模型

    支持多家提供方,先配能用的那个。

  3. 3写第一个调用

    用统一接口发起对话,注意返回的是可迭代对象。

  4. 4试结构化输出

    它把返回直接解析成你定义的类型,这是它相对裸 SDK 的主要价值。

如何确认成功

按你定义的数据结构拿到解析好的对象,字段缺失时会明确报错而不是静默给空值

注意事项

  • 它把多家模型的调用接口统一,并在其上加了结构化输出与工具调用。
  • 结构化输出依赖模型遵循格式,小模型经常漏字段。
  • 封装层会隐藏部分供应商特有参数,需要细调时要绕过它。
  • 版本迭代较快,接口有小幅变动,锁版本再上线。

核心亮点

  • 基于 pydantic 做结构化输出,返回结果可直接当类型化对象使用,减少手工解析 JSON 的样板代码
  • 底层用 litellm 统一多家模型接口,切换供应商时业务代码改动小
  • 框架定位轻量,依赖少,容易嵌入现有 Python 项目而非另起一套编排体系

不足之处

  • 项目处于早期,星标约 418,生态和第三方集成相对有限
  • 相比成熟编排框架,复杂多步 agent 流程与可观测性能力可能不够完善

适用场景

  • 需要从 LLM 稳定抽取结构化字段并写入数据库或下游系统的场景
  • 在多个模型供应商之间切换或做 A/B 对比的 Python 应用
  • 把 LLM 调用作为函数嵌入已有后端服务,而非搭建独立 agent 平台

替代项目

LangChain、LlamaIndex、instructor

上一篇:go-zero

下一篇:Maze

同类项目推荐

PerforatedAI 开源

给PyTorch模型装上树突,提升表达力

Add Dendrites to your PyTorch Project

★ 241 2026-08-09
swarmauri-sdk 开源

模块化 AI 智能体 SDK,快速组装 LLM 应用

Modular Python SDK and monorepo for AI agents, LLM integrations, tools, parsers, emb···

★ 106 2026-08-09
agent-inspect 开源

终端里看清 AI 代理每一步,调试不再抓瞎

Local evidence debugger and trajectory-test toolkit for TypeScript AI agents: inspec···

★ 212 2026-08-09
ai-toolkit 开源

用图数据库搭 AI Agent,关系推理一步到位

Open-source tools for AI on Memgraph: persistent agent memory, knowledge graphs, Gra···

★ 119 2026-09-12
zenml 开源

用代码编排 AI 管道,从实验到生产一键切换

ZenML : One AI Platform from Pipelines to Agents. https://zenml.io.

★ 5635 2026-08-09
ai-react-markdown 开源

让 AI 流式 Markdown 渲染更流畅、更懂中文、更全能

Markdown rendering for AI applications: incremental streaming, LaTeX math, GFM, and ···

★ 170 2026-08-09
stop-that-shit 开源

拦住 Codex 乱加依赖,让 AI 改动保持精简。

Stop That Shit(别再造史了)|面向 Codex/GPT 场景的多平台 Hook + Skill Guard:拦截 A···

★ 4038 2026-08-16
symbolicai 开源

给大模型装上符号推理引擎,让逻辑更可靠

A neurosymbolic perspective on LLMs

★ 1783 2026-08-09
knowledge-graph-of-thoughts 开源

用知识图谱引导AI推理,低成本获得更准答案

Official Implementation of "Affordable AI Assistants with Knowledge Graph of Thought···

★ 232 2026-08-09