SpringBootAI
SpringBootAI 是一个采用 Spring 风格注解和分层结构的 Python 应用框架。你可以使用 Python 编写 @RestController、@Service、@Mapper 和 @Autowired，框架负责组件扫描、依赖注入、Web 路由、事务切面及应用生命周期。
Web 运行时建立在 FastAPI、Starlette 和 Uvicorn 之上，同时提供 ORM、事务、缓存、消息队列、服务发现、生产治理以及 AI 生态集成。
SpringBootAI 不是 Java Spring Boot 的 Python 绑定，也不是 Spring 官方项目。它适合熟悉 Controller、Service、Mapper 分层方式的团队，用统一写法开发 Web API、内部管理系统、数据服务和 AI 应用。
安装
SpringBootAI 2.3.6 支持 Python 3.10、3.11 和 3.12：
python -m pip install springbootAI
需要可选模块时，可以按需安装：
python -m pip install "springbootAI[ai]"
python -m pip install "springbootAI[langchain]"
python -m pip install "springbootAI[langgraph]"
python -m pip install "springbootAI[mcp]"
python -m pip install "springbootAI[mysql]"
python -m pip install "springbootAI[redis]"
安装全部可选能力：
python -m pip install "springbootAI[all]"
快速开始
创建应用入口 demo/Application.py：
from springbootai.annotations import SpringBootApplication
from springbootai.main import run
@SpringBootApplication(scan_base_packages=["demo"])
class Application:
pass
if __name__ == "__main__":
run(Application)
创建控制器 demo/controller/HelloController.py：
from springbootai.annotations import GetMapping, RequestMapping, RestController
from springbootai.web.swagger import Operation, Tag
@Tag(name="入门接口", description="确认应用已经正常运行")
@RequestMapping("/api")
@RestController
class HelloController:
@Operation(summary="打招呼")
@GetMapping("/hello/{name}")
def hello(self, name: str):
return {"message": f"Hello, {name}"}
创建 demo/application.yml，首次运行时关闭暂时不需要的外部资源：
server:
host: 127.0.0.1
port: 8080
database:
enabled: false
redis:
enabled: false
启动应用：
python -m demo.Application
访问 http://127.0.0.1:8080/api/hello/Alice 验证接口，访问 http://127.0.0.1:8080/docs 查看 Swagger 文档。
核心能力
| 方向 | 能力 |
|---|---|
| Web 与 IoC | 路由映射、参数绑定、组件扫描、依赖注入、生命周期、Swagger |
| 数据与事务 | PyMyBatis Mapper、XML Mapper、分页、动态 SQL、事务和自动回滚 |
| 中间件与 Cloud | Redis、RabbitMQ、Kafka、Nacos、Feign、Gateway |
| 工程治理 | 配置合并、Profile、日志、健康检查、Prometheus、限流、熔断和链路追踪 |
| 安全能力 | JWT、OAuth2、CSRF、访问控制、密码加密和 SQL 注入防护 |
| AI 生态 | ChatClient、Tools、RAG、Advisor、LangChain、LangGraph 和 MCP client/server |
| 测试能力 | 测试切片、MockBean、TestPropertySource、集成测试和性能测试脚本 |
考试认证与证书
SpringBootAI 提供配套的在线考试认证平台。学习者、团队成员和项目使用方可以通过认证考试检验自己对框架核心能力的掌握情况，并在通过考试后获得对应证书。
认证内容建议重点关注：
- 安装、项目结构、启动入口、扫描包、配置文件和 Swagger。
- Controller、Service、Mapper 分层以及 Bean 注册、依赖注入和生命周期。
- PyMyBatis、动态 SQL、分页、事务边界和回滚行为。
- Profile、日志、健康检查、Prometheus、限流、熔断和测试切片。
- JWT、OAuth2、CSRF、访问控制和常见安全错误处理。
- ChatClient、Tools、RAG、LangChain、LangGraph 和 MCP。
考试规则、题量、通过标准、证书领取方式和有效期以认证平台展示为准。
文档
生产使用说明
项目当前标记为 Beta。用于公网高并发、合规敏感或支付、订单、库存等核心系统前，请完成目标数据库、流量模型、故障恢复和安全基线验证。
内嵌 Gateway 适合内部路由，不替代公网 Nginx、Kong 或 WAF。Seata distributed 模式对接官方 TC 与 TCC 回调；at 模式通过 ORM 拦截器生成 undo_log 实现自动回滚。
许可证
SpringBootAI 使用 MIT License。
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file springbootai-2.3.6.tar.gz.
File metadata
- Download URL: springbootai-2.3.6.tar.gz
- Upload date:
- Size: 913.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
310a92cf72b40eb4afb6ce27bc859019361ecdc4b66509ff388010803214862d
|
|
| MD5 |
733911350fbc30c3e6fc26e1227b2f5b
|
|
| BLAKE2b-256 |
dd3f4749993f659310c3588a6f80fe054f27cbc2d9632f51cc36bd4a99830681
|
Provenance
The following attestation bundles were made for springbootai-2.3.6.tar.gz:
Publisher:
publish.yml on YUCONGGEN/springbootAI
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
springbootai-2.3.6.tar.gz -
Subject digest:
310a92cf72b40eb4afb6ce27bc859019361ecdc4b66509ff388010803214862d - Sigstore transparency entry: 2524494900
- Sigstore integration time:
-
Permalink:
YUCONGGEN/springbootAI@20dcbcddaf2cfad4ffa9cf31a16b68df1643e47f -
Branch / Tag:
refs/tags/v2.3.6 - Owner: https://github.com/YUCONGGEN
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@20dcbcddaf2cfad4ffa9cf31a16b68df1643e47f -
Trigger Event:
release
-
Statement type:
File details
Details for the file springbootai-2.3.6-py3-none-any.whl.
File metadata
- Download URL: springbootai-2.3.6-py3-none-any.whl
- Upload date:
- Size: 711.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f72fc2077be3eb6a4e4455c48489d6438d89cf818f62bb8bd146ab2e5596a724
|
|
| MD5 |
642dda3232f53bebeed7fee99fc3537a
|
|
| BLAKE2b-256 |
825a1c3440e5eac7696f631b5ea45ef17eb50d308ff1a21dba3756bb8642ceb3
|
Provenance
The following attestation bundles were made for springbootai-2.3.6-py3-none-any.whl:
Publisher:
publish.yml on YUCONGGEN/springbootAI
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
springbootai-2.3.6-py3-none-any.whl -
Subject digest:
f72fc2077be3eb6a4e4455c48489d6438d89cf818f62bb8bd146ab2e5596a724 - Sigstore transparency entry: 2524495681
- Sigstore integration time:
-
Permalink:
YUCONGGEN/springbootAI@20dcbcddaf2cfad4ffa9cf31a16b68df1643e47f -
Branch / Tag:
refs/tags/v2.3.6 - Owner: https://github.com/YUCONGGEN
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@20dcbcddaf2cfad4ffa9cf31a16b68df1643e47f -
Trigger Event:
release
-
Statement type:
