FlyPython 只在维护者审查过项目源码、维护状态、许可证、文档、发布历史与 实际使用价值之后，才会推荐当前流行的 Python 项目。本目录有意不收录任何 未经核实或 AI 生成的推荐。
每个已审查项目对应本目录下的一个 YAML 文件（<id>.yml）。下表由
tools/render_readmes.py 从这些文件生成；请修改 YAML，不要直接改表。
仓库根目录的 radar.json 是面向"固定仓库提交"消费者的机器可读导出。
ai_familiarity 记录主流模型训练数据对该项目及其当前 API 的覆盖程度——
评级规则见 docs/CURATION_POLICY.md。
| 项目 | 类别 | 状态 | AI 熟悉度 | 推荐理由 | 何时不用 / 风险 | 审核日期 |
|---|---|---|---|---|---|---|
| fastapi fastapi/fastapi · MIT |
Web 与 API | stable |
AI 熟悉度：高 | 生产级 ASGI 框架，自带 OpenAPI 文档、Pydantic 校验与依赖注入。 | 非 HTTP 服务，或已围绕 Django 自带 ORM 与 admin 体系标准化的 团队。<br>**风险：**需正确处理后台任务异常、审慎使用 async 端点；在 async 路由中执行阻塞 调用会拖垮整个服务。 | 2026-09-02 |
| instructor 567-labs/instructor · MIT |
AI 工具 | stable |
AI 熟悉度：中 | 从 LLM 提取结构化 JSON 的事实标准，基于 Pydantic 模型并带重试 校验。 | 所用提供商已原生强制结构化输出、且不需要更多能力时。<br>**风险：**需要目标 LLM 提供商的 API Key；重试循环会增加延迟与 token 成本。 | 2026-09-02 |
| marimo marimo-team/marimo · Apache-2.0 |
交互式笔记本 | rising |
AI 熟悉度：低 | 响应式纯 Python 笔记本，以标准可执行 .py 文件保存，状态执行具有 确定性。 | 工作流依赖 Jupyter 专属扩展，或内核状态调试是核心流程时。<br>**风险：**需要现代浏览器环境；它是 Jupyter 工作流的替代而非扩展。 | 2026-09-02 |
| polars pola-rs/polars · MIT |
数据与管线 | stable |
AI 熟悉度：中 | 高性能 DataFrame 库，基于 Rust 与 Apache Arrow，支持惰性查询 优化。 | 管线依赖 pandas 生态（accessor、小众库）或需要重度索引语义时。<br>**风险：**API 与 pandas 不同、内存为列式布局；迁移需要预留时间，不能当作 直接替换。 | 2026-09-02 |
| pydantic-ai pydantic/pydantic-ai · MIT |
AI Agent | rising |
AI 熟悉度：低 | 模型无关的 Agent 框架，优先保证类型安全的结构化输出、依赖注入与 可测试性。 | 需要当下就稳定的长周期 API，或重度多 Agent 编排能力时。<br>**风险：**API 演进迅速；固定小版本，每次升级后重跑评测。 | 2026-09-02 |
| ruff astral-sh/ruff · MIT |
代码质量 | stable |
AI 熟悉度：高 | 快 10–100 倍的 linter 与格式化工具，把 Flake8、Black、isort、 pyupgrade 规则统一到一份配置里。 | 项目依赖尚无 Ruff 等价实现的插件生态（如 Flake8 插件）时。<br>**风险：**与 Black 基本兼容；在非常规代码上偶见语法解析差异。 | 2026-09-02 |
| uv astral-sh/uv · MIT OR Apache-2.0 |
工具与打包 | stable |
AI 熟悉度：中 | 极快的 Rust 实现的包与项目管理器，以锁文件确定性取代 pip、 pip-tools、venv 与 pyenv。 | 必须沿用既有 pip-tools 或 Poetry 工作流时，或缺少 wheel 镜像的离线环境中。<br>**风险：**由 Astral 积极维护；依赖预编译二进制 wheel，升级时需做供应链审查。 | 2026-09-02 |
radar.json— 所有已审查项目的确定性导出（网站消费者与catalog.json一起按提交固定）。candidates.json—tools/radar_scan.py的输出；原始发现候选， 不含描述、不含状态，直到有人完成人工审查。
请使用项目提案表单
推荐项目。被接受的记录会使用以下生命周期状态之一：new、rising、
stable、major-update、experimental 或 archived。"new" 描述的是
近期完成的已审查发现，而不是未经证实的质量背书。