FlyPython 是一个面向实践的双语仓库，帮助你写好 Python，并把代码变成用户可以依赖的 产品。这里同时提供 AI Coding 方法、任务 Playbook、可运行示例、复用模板，以及 API、 自动化、Agent、Skill 和 MCP 的一手资料。
这不是初学者链接合集。目标是帮助你从“Agent 写出了代码”走到“用户结果已经验证”。本仓库 维护经过审核的源内容与数据，flypython.com 把固定版本呈现为更适合 阅读和发现的学习体验。
只需要 Python 3.11+：
git clone https://github.com/flypythoncom/python.git
cd python
python examples/product-slug/verify.py starter --expect-failure
python examples/product-slug/verify.py solution你刚刚复现了一个 Bug，并验证了修复后的行为。接下来把任务契约 交给 coding agent，让 starter 通过测试，但先不要复制 solution。
| 目标 | 从这里开始 | 最终产出 |
|---|---|---|
| 安全地编写和修改 Python | AI Coding 工作方法 | 上下文明确、有证据的边界修改 |
| 把 Python 变成可靠产品 | 产品质量指南 | 可测试、可观测、可回退的产品路径 |
| 完成反复出现的工程任务 | Playbook | Bug 修复、API 修改、外部集成、依赖升级或发布 |
| 动手练习而不只是阅读 | 可运行示例 | 有失败 starter 和验证后 solution 的本地小项目 |
| 给 agent 更好的任务信息 | 模板 | 任务契约、计划、Review 与验证记录 |
| 构建 Agent、Skill、MCP、API 或自动化 | 已审核资料目录 | 适合当前用途的一手资料路径 |
| 发现近期值得关注的 Python 项目 | Project Radar 审核队列 | 经维护者审核、带证据的项目短名单 |
工作循环很简单：定义用户结果、检查真实上下文、完成最小可测试修改、验证行为、审查副作用， 并记录尚未验证的部分。AI 可以加速这个循环，但不能替代工程判断。
希望按路径阅读并持续获得更新，可以继续前往 flypython.com。仓库仍然是可检查的源内容，网站帮助你选择下一步。
先选择一条学习路径，再打开符合当前目标的官方资料。目录会说明每项资源为什么被收录、 适合什么阶段，以及需要关注的访问条件和安全边界。
29 条已审核资源 · 最近整体审核：2026-09-02 · 21 条进阶或高级资源 · 一手来源优先
- Python 基础 — 掌握语言基础、环境、依赖、类型与测试，为可靠的 Python 项目打好根基。 (8 条资源)
- Web 与 API — 构建有类型约束的服务和应用，把 Python 逻辑连接到用户与其他系统。 (7 条资源)
- 自动化 — 把重复工作变成可维护的脚本、浏览器工作流和数据管道。 (7 条资源)
- AI Agent — 理解工具调用、结构化输出、状态、评测以及 Agent 系统的安全边界。 (7 条资源)
掌握语言基础、环境、依赖、类型与测试，为可靠的 Python 项目打好根基。
| 资源 | 为什么值得看 | 难度与语言 | 访问与风险 | 审核日期 |
|---|---|---|---|---|
| The Python Tutorial 官方文档 · 精选 |
Python 官方入门教程，覆盖语法、数据结构、模块、异常、类与标准库。 | 入门 英语 |
无需 API Key 低风险 |
2026-08-31 |
| venv — Creation of virtual environments 官方文档 |
Python 标准库的虚拟环境参考，说明如何创建隔离环境及其运行方式。 | 入门 英语 |
无需 API Key 低风险 |
2026-08-31 |
| Python Packaging User Guide 官方文档 |
PyPA 官方教程，覆盖项目结构、构建元数据、分发包与 Python 包发布。 | 进阶 英语 |
无需 API Key 低风险 |
2026-08-31 |
| uv documentation 官方项目 · 精选 |
现代 Python 工作流，统一管理版本、虚拟环境、依赖、锁文件和项目命令。 | 所有阶段 英语 |
无需 API Key 低风险 |
2026-08-31 |
| pytest documentation 官方项目 |
pytest 官方指南，覆盖测试发现、断言、fixture、参数化和可维护测试套件。 | 进阶 英语 |
无需 API Key 低风险 |
2026-08-31 |
| Python typing documentation 官方文档 |
Python 类型系统规范、指南与类型标注实践的权威入口。 | 进阶 英语 |
无需 API Key 低风险 |
2026-08-31 |
| Ruff documentation 官方项目 · 精选 |
极速的 Rust 驱动 Python 代码检查与格式化工具，统一替代 Flake8、Black 与 isort。 | 所有阶段 英语 |
无需 API Key 低风险 |
2026-09-02 |
| Mypy documentation 官方项目 |
Python 官方与社区主流的静态类型检查器，在运行前拦截类型错误并验证代码契约。 | 进阶 英语 |
无需 API Key 低风险 |
2026-09-02 |
构建有类型约束的服务和应用，把 Python 逻辑连接到用户与其他系统。
| 资源 | 为什么值得看 | 难度与语言 | 访问与风险 | 审核日期 |
|---|---|---|---|---|
| FastAPI documentation 官方文档 · 精选 |
从带类型的 Python 函数出发，构建具备验证、测试和自动文档的 API。 | 进阶 英语 |
无需 API Key 低风险 |
2026-08-31 |
| Django documentation: First steps 官方文档 |
Django 官方入门路径，覆盖项目、模型、视图、模板、表单、测试和可复用应用。 | 入门 英语 |
无需 API Key 低风险 |
2026-08-31 |
| Flask documentation 官方文档 |
Flask 官方参考与教程，覆盖应用、请求、模板、测试和部署。 | 入门 英语 |
无需 API Key 低风险 |
2026-08-31 |
| Pydantic documentation 官方文档 |
在 Python 系统边界验证不可信数据、定义类型契约的官方指南。 | 进阶 英语 |
无需 API Key 低风险 |
2026-08-31 |
| HTTPX documentation 官方项目 |
同步与异步 HTTP 客户端、超时、流式响应和传输控制的官方参考。 | 进阶 英语 |
无需 API Key 低风险 |
2026-08-31 |
| SQLAlchemy documentation 官方项目 |
Python 权威的 SQL 工具包与对象关系映射器（ORM），提供类型安全的数据持久化与访问。 | 进阶 英语 |
无需 API Key 低风险 |
2026-09-02 |
| Alembic documentation 官方项目 |
基于 SQLAlchemy 的数据库迁移事实标准工具，提供事务性架构演进与版本回滚支持。 | 进阶 英语 |
无需 API Key 检查权限与副作用 |
2026-09-02 |
把重复工作变成可维护的脚本、浏览器工作流和数据管道。
| 资源 | 为什么值得看 | 难度与语言 | 访问与风险 | 审核日期 |
|---|---|---|---|---|
| pathlib — Object-oriented filesystem paths 官方文档 |
使用可读、跨平台的对象式路径完成文件与目录自动化的标准库参考。 | 入门 英语 |
无需 API Key 低风险 |
2026-08-31 |
| subprocess — Subprocess management 官方文档 |
启动进程、捕获输出、处理失败并避免不安全 shell 用法的标准库契约。 | 进阶 英语 |
无需 API Key 检查权限与副作用 |
2026-08-31 |
| Playwright for Python 官方文档 |
可靠浏览器自动化、定位器、断言、追踪和隔离上下文的 Python 官方指南。 | 进阶 英语 |
无需 API Key 检查权限与副作用 |
2026-08-31 |
| Scrapy tutorial 官方文档 |
爬虫结构、数据提取、item pipeline、持久化与负责任运行的官方入门。 | 进阶 英语 |
无需 API Key 检查权限与副作用 |
2026-08-31 |
| pandas getting started guides 官方文档 |
表格数据读取、清洗、转换、分析和导出的官方入门入口。 | 入门 英语 |
无需 API Key 低风险 |
2026-08-31 |
| Polars documentation 官方项目 |
基于 Apache Arrow 和 Rust 构建的极速 DataFrame 库，专为并行计算与现代数据管道优化。 | 进阶 英语 |
无需 API Key 低风险 |
2026-09-02 |
| DuckDB Python API documentation 官方项目 |
进程内高性能分析型 SQL 引擎，适用于自动化数据转换、Parquet 文件快速查询与嵌入式分析。 | 进阶 英语 |
无需 API Key 低风险 |
2026-09-02 |
理解工具调用、结构化输出、状态、评测以及 Agent 系统的安全边界。
| 资源 | 为什么值得看 | 难度与语言 | 访问与风险 | 审核日期 |
|---|---|---|---|---|
| OpenAI Agents SDK 官方文档 · 精选 |
面向 Agent、工具、handoff、guardrail、session、追踪与编排的官方 Python 工具包。 | 进阶 英语 |
通常需要 API Key 检查权限与副作用 |
2026-08-31 |
| Pydantic AI 官方文档 · 精选 |
以输入验证、结构化输出、工具、测试和模型可移植性为核心的类型安全 Agent 开发。 | 进阶 英语 |
通常需要 API Key 检查权限与副作用 |
2026-08-31 |
| Model Context Protocol 正式标准 · 精选 |
连接 AI 应用、工具、数据与可复用上下文的开放协议和权威参考。 | 进阶 英语 |
无需 API Key 检查权限与副作用 |
2026-08-31 |
| LangGraph overview 官方文档 |
有状态图工作流、持久执行、记忆、中断与人工审核的 Python 官方指南。 | 高级 英语 |
通常需要 API Key 检查权限与副作用 |
2026-08-31 |
| Google Agent Development Kit 官方文档 |
Google 官方模块化 Agent 系统开发、评测与部署文档。 | 高级 英语 |
通常需要 API Key 检查权限与副作用 |
2026-08-31 |
| Instructor documentation 官方项目 |
基于 Pydantic 的大模型结构化输出与严格验证框架，确保工具调用与数据提取的确定性。 | 进阶 英语 |
通常需要 API Key 检查权限与副作用 |
2026-09-02 |
| Model Context Protocol Python SDK 官方项目 |
Model Context Protocol 官方 Python SDK，用于快速构建和集成标准的 MCP 工具与服务。 | 进阶 英语 |
无需 API Key 检查权限与副作用 |
2026-09-02 |
没有找到合适的官方资料？可以建议资源或报告错误。
- 中英文第一方指南和任务 Playbook；
- 可运行、可验证的 Python 示例与 agent 工作模板；
- 经过审核的官方文档、正式标准与项目一手来源；
- 确定性的 manifest、校验、导出和安全链接审计；
- 最新 Python 项目 Radar 的人工审核入口。
网站负责展示、导航、搜索、Newsletter 和未来的付费体验，并主动同步本仓库某个固定版本； 网站不能暗中复制或重写这里的源内容结论。 维护者可以按照仓库到网站的运营模型增加可衡量的下一步，但不能 把尚未提供的产品包装成现货。
catalog/
catalog.yml 目录状态和审核日期
paths.yml 中英文学习路径定义
resources/ 每项资源一个 YAML 文件
projects/ 最新 Python 项目的人工审核队列
guides/ Python 工程与 AI Coding 方法
playbooks/ 可重复任务步骤与完成标准
examples/ 带自动验证的可运行小项目
templates/ 任务、计划、Review 和验证模板
schema/
*.schema.json 带版本的机器可读契约
catalog.json 提供给网站使用的确定性公开导出
content-manifest.json 网站使用的版本、路径、摘要与校验值
tools/ 生成、校验、示例和链接审计工具
tests/ 内容一致性与行为测试
docs/ 消费方契约和策展政策
catalog.json 和 content-manifest.json 都由工具生成，不能手工修改。网站应从完整
commit SHA 读取两份导出、校验文件摘要，并在自己的锁文件中记录该版本；生产构建不能
直接追随持续变化的分支。
固定版本地址示例：
https://raw.githubusercontent.com/flypythoncom/python/<full-commit-sha>/catalog.json
内容 manifest 让 flypython.com 可以渲染对应的中英文指南或 Playbook，而不用维护第二份 可编辑副本。项目推荐在维护者完成源码、维护状态、许可证、发布、安全与实际用户价值审核前 保持为空，不用 AI 生成推荐理由来填充栏目。
使用 .python-version 指定的 Python，并安装锁定的开发依赖：
python -m venv .venv
. .venv/bin/activate
python -m pip install -r requirements-dev.lock.txt运行与 CI 相同的确定性校验：
python -m pytest
python tools/validate_catalog.py
python tools/export_catalog.py --check
python tools/render_readmes.py --check
python tools/build_content_manifest.py --check
python tools/verify_examples.py修改源内容后重新生成：
python tools/export_catalog.py
python tools/render_readmes.py
python tools/build_content_manifest.py网络链接检查不会在 Pull Request 中运行，而是由维护者通过定时或手动的 Catalog link audit 工作流执行。
提交资源或修改分类前，请先阅读 CONTRIBUTING.md 和 策展政策。网站接入还应遵循 消费方契约。
