# FlyPython (flypython.com)

> Production Python for the AI Era. Verified engineering playbooks, test-first architectures, and runnable reference implementations for human engineers and AI coding agents.

FlyPython provides concise, runnable, and testable engineering patterns rather than superficial code snippets. All examples run on Python 3.12+ and are verified in CI with automated tests and linting.

## Core Learning Paths & Guides
- [Python foundations with tests](https://flypython.com/learn/python-foundations-with-tests): Environment isolation, explicit function contracts, and automated success/failure tests.
- [Build a Python product that can be changed safely](https://flypython.com/learn/python-product-quality): Explicit boundaries, tested failure paths, observable operation, and reversible releases.
- [Modern Python typing in practice](https://flypython.com/learn/modern-python-typing): Protocol, TypedDict, PEP 695 generics, and static type checking as machine-enforced contracts.
- [Decide whether to adopt free-threaded Python](https://flypython.com/learn/free-threaded-python-decision): The 3.15 free-threaded Stable ABI, a workload-based decision checklist, and a dual-build CI check with uv.
- [Adopt the uv workflow for Python projects](https://flypython.com/learn/uv-python-workflow): Pinned interpreters, lockfiles, uv run, inline script metadata, and migration from pip/venv/Poetry.
- [Python web API boundaries](https://flypython.com/learn/python-web-api-boundaries): Pydantic validation, boundary errors, timeouts, and deterministic test contracts.
- [Safe, retryable Python automation](https://flypython.com/learn/safe-retryable-python-automation): Checkpoint design, idempotency, bounded backoff, and failure recovery.
- [Reliable async Python patterns](https://flypython.com/learn/reliable-async-patterns): Event-loop discipline, TaskGroup, Semaphore bounds, and cancellation cleanup.
- [Python AI agent roadmap](https://flypython.com/learn/python-ai-agent-roadmap): Deterministic agent loops, action-name traces, and narrow tool boundaries without external API keys.
- [Migrate a Python MCP server to 2026-07-28](https://flypython.com/learn/mcp-2026-07-28-migration): Remove the initialize handshake, adopt the input_required round-trip, and drop deprecated features.
- [Use Python well with AI coding](https://flypython.com/learn/ai-coding-workflow): Task contracts, repository inspection, reproducible environments, and evidence-based handoffs.
- [Context budgeting and bounded tasks](https://flypython.com/learn/ai-coding-context-budget): Attention budgets, machine-checkable contracts, and fast verification loops.
- [Give every coding agent one AGENTS.md source of truth](https://flypython.com/learn/agents-md-single-source): The AAIF-governed AGENTS.md standard, what belongs in the file, and how to keep one source of truth.
- [Build LLM prompts with template strings](https://flypython.com/learn/t-strings-for-llm-prompts): Python 3.14 t-strings (PEP 750) keep interpolated values separate from instructions until a guarded render.

## Chinese Content (zh-CN)
- 中文指南索引: https://flypython.com/learn/zh — 产品质量、类型系统、异步模式、MCP 迁移与 AI Coding 六篇中文指南。
- 中文可运行示例: https://flypython.com/examples/zh

## On-Site Playbooks
- [Start a Python project you can verify](https://flypython.com/resources#python-project-verification): Isolated environment, recorded commands, and a tested function contract.
- [Write an API boundary before choosing a framework](https://flypython.com/resources#http-boundary-contract): Validation rules, deadlines, and a boundary test matrix for one endpoint.
- [Design a retryable automation run](https://flypython.com/resources#retryable-run-contract): Run IDs, checkpoints, idempotency, retry limits, and completion evidence.
- [Run an agent loop before adding a model](https://flypython.com/resources#bounded-agent-loop): Deterministic planner, action-name trace, and 13 automated tests without an API key.

All twelve playbooks — including API changes, external integrations, migrations, structured logging, releases, and LLM evals — are indexed at https://flypython.com/resources#playbooks.

## Runnable Examples
- [MCP tool server (2026-07-28 spec)](https://flypython.com/examples/mcp-server): Stateless JSON-RPC dispatch with no initialize handshake, schema validation, and the input_required round-trip.
- [Async batch fetcher](https://flypython.com/examples/async-fetcher): Concurrency control with asyncio.Semaphore and exponential backoff.
- [Pydantic boundary validation](https://flypython.com/examples/pydantic-validation): Parse and validate untrusted payloads with schema checks.
- [Resilient batch pipeline](https://flypython.com/examples/structured-pipeline): Safe batch processing with per-item error isolation and field validation.
- [Product slug normalization](https://flypython.com/examples/product-slug): A three-minute AI-coding change with a regression test.

All examples are indexed at https://flypython.com/examples with one-command verifiers.

## Open Source Repository
- GitHub Repository: https://github.com/flypythoncom/python
- Runnable Examples Directory: https://github.com/flypythoncom/python/tree/master/examples
- Machine-Readable Catalog: https://raw.githubusercontent.com/flypythoncom/python/master/catalog.json
- Content Manifest: https://raw.githubusercontent.com/flypythoncom/python/master/content-manifest.json
- Agent IDE Rules (.cursorrules / Copilot): https://raw.githubusercontent.com/flypythoncom/python/master/templates/AGENT_RULES.example.md
- Coding Agent Policy (AGENTS.md): https://raw.githubusercontent.com/flypythoncom/python/master/templates/AGENTS.example.md

## Machine-Readable Resources
- Full LLM Index: https://flypython.com/llms-full.txt
- RSS Feed: https://flypython.com/rss.xml