feat: rebuild the reviewed Python catalog

Author: xxg1413

README.md

@@ -1,175 +1,49 @@
-# 🐍 FlyPython - LLM Agent & AI Development Hub
+# FlyPython Python Resource Catalog
 
-[python.flypython.com](https://python.flypython.com)
+[![GitHub stars](https://img.shields.io/github/stars/flypythoncom/python?style=flat-square&label=stars)](https://github.com/flypythoncom/python/stargazers)
+[![GitHub forks](https://img.shields.io/github/forks/flypythoncom/python?style=flat-square&label=forks)](https://github.com/flypythoncom/python/forks)
+[![Catalog](https://img.shields.io/badge/catalog-reviewed-157878?style=flat-square)](https://python.flypython.com/)
 
-## 🤖 LLM Agent Python - Core Focus
+[English](README.md) · [中文](README_cn.md)
 
-### 🚀 Leading LLM Agent Frameworks
+FlyPython is the broad, community-maintained resource catalog behind the
+[FlyPython learning hub](https://flypython.com/). It keeps the larger source map
+public and reviewable while the main site provides editorial learning paths and a
+smaller featured collection.
 
-#### **OpenAI Agents SDK**
-- [OpenAI Agents Python Documentation](https://openai.github.io/openai-agents-python/) - Official OpenAI Agents SDK for building Python agents
-- [OpenAI Agents SDK Quickstart](https://openai.github.io/openai-agents-python/quickstart/) - Official quickstart guide
-- [OpenAI Python Library](https://github.com/openai/openai-python) - Official OpenAI Python client
-- [OpenAI Developer Resources](https://developers.openai.com/resources) - Official OpenAI development resource hub
+## Start here
 
-#### **CrewAI - Multi-Agent Systems**
-- [CrewAI Framework](https://github.com/joaomdmoura/crewAI) - Framework for orchestrating role-playing, autonomous AI agents
-- [CrewAI Documentation](https://docs.crewai.com/) - Official CrewAI documentation
-- [CrewAI Examples](https://github.com/crewAIInc/crewAI-examples) - Official example projects
-- [Learn Agentic AI with CrewAI](https://github.com/panaversity/learn-agentic-ai) - Broad CrewAI learning resources
+- [Follow the practical Python roadmap](https://flypython.com/learn)
+- [Browse the featured resource index](https://flypython.com/resources)
+- [Build and test a no-key Python agent loop](https://flypython.com/learn/python-ai-agent-roadmap)
+- [Explore the full community catalog](https://python.flypython.com/)
 
-#### **LangGraph - Advanced Agent Workflows**
-- [LangGraph](https://github.com/langchain-ai/langgraph) - Build stateful, multi-actor applications with LLMs
-- [LangChain Agent Tutorials](https://python.langchain.com/docs/tutorials/) - Official agent and tool-calling tutorials
+## Four paths
 
-#### **AutoGen - Conversational AI Agents**
-- [Microsoft AutoGen](https://github.com/microsoft/autogen) - Multi-agent conversation framework
+1. **Python foundations** — language, environments, dependencies, typing, and tests
+2. **Web and APIs** — typed services, validation, HTTP clients, and applications
+3. **Automation** — files, processes, browsers, crawling, and data workflows
+4. **AI agents** — tools, structured output, state, evaluation, and safety boundaries
 
-#### **Agent Development Infrastructure**
-- [Anthropic Tool Use](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/overview) - Official guide to tool calling and agent workflows
-- [Google Agent Development Kit](https://google.github.io/adk-docs/) - Official Google ADK docs
-- [Model Context Protocol](https://modelcontextprotocol.io/introduction) - Open protocol for connecting models to tools and external context
-- [PydanticAI](https://ai.pydantic.dev/) - Type-safe Python agent framework
-- [Mastra Docs](https://mastra.ai/docs) - Agent framework with workflows, evals, and observability
-- [Dapr Python SDK](https://github.com/dapr/python-sdk) - Building blocks for distributed and stateful Python services
+The canonical catalog lives in [`_data/resources.yml`](_data/resources.yml).
+The English and Chinese site pages read from that same file; the full resource
+list is not copied into the README files.
 
-### 🛠️ Open Source LLM Agent Projects
+## Quality bar
 
-#### **Minimal & Educational**
-- [min-agent](https://github.com/zhouzaida/min-agent) - Minimal 200-line LLM agent for understanding core principles
-- [LangChain ReAct Agent](https://github.com/botextractai/ai-langchain-react-agent) - ReAct agent with Python REPL and search
-- [OpenSource LLM Agents ReAct](https://github.com/Praveengovianalytics/llm_agents_open_source) - Open-source ReAct implementation references
+- Prefer official documentation, standards, and first-party project sources.
+- Explain why each resource matters instead of publishing an unranked link dump.
+- Record the review date, API-key requirement, and relevant safety boundary.
+- Label experiments honestly; do not infer production readiness from popularity.
 
-#### **Production-Ready Frameworks**
-- [SuperModels](https://github.com/JohannesVC/SuperModels) - Desktop app for running LLM agents with reflection mechanisms
-- [AgentKit](https://github.com/japanvik/agentkit) - Lightweight toolkit for distributed agents
+See [CONTRIBUTING.md](CONTRIBUTING.md) before proposing a resource or changing
+its classification.
 
-### 📚 LLM Agent Learning Resources
+## Local preview
 
-#### **Comprehensive Guides**
-- [OpenAI Cookbook](https://cookbook.openai.com/) - Official examples and production patterns
-- [Prompt Optimization Guide](https://cookbook.openai.com/examples/optimize_prompts) - Practical prompt improvement workflow
+```bash
+bundle install
+bundle exec jekyll serve
+```
 
-#### **Courses & Tutorials**
-- [Agentic AI Development Course](https://github.com/panaversity/learn-agentic-ai) - Complete course repository for agentic AI
-- [Python for AI and Machine Learning](https://realpython.com/learning-paths/machine-learning-python/) - Python AI learning path
-
-## 📖 Python Learning & Development
-
-### 🎯 Quick Navigation
-
-1. [Python News](#python-news)
-2. [Python Books](#python-books)
-3. [Courses](#courses)
-4. [Algorithms & Data Structures](#algorithms)
-5. [Web Development](#web-development)
-6. [Data Science & Analysis](#data-science)
-7. [Automation & Bots](#automation--bots)
-8. [Finance & Trading](#finance--trading)
-9. [Performance Optimization](#performance)
-
----
-
-### Python News
-
-- [Python Official](https://www.python.org/)
-- [Python Insider](https://blog.python.org/)
-- **Reddit Communities:**
-  - [r/Python](https://www.reddit.com/r/Python/)
-  - [r/learnpython](https://www.reddit.com/r/learnpython/)
-  - [r/pythontips](https://www.reddit.com/r/pythontips/)
-  - [r/pythoncoding](https://www.reddit.com/r/pythoncoding)
-
-### Python Books
-
-#### **For Beginners**
-- **Python Crash Course: A Hands-On, Project-Based Introduction to Programming** (3rd Edition, 2023)
-  - [Amazon](https://www.amazon.com/Python-Crash-Course-Hands-Project-Based/dp/1718502702)
-- **Starting Out with Python** (4th Edition)
-  - [Amazon](https://www.amazon.com/Starting-Out-Python-Tony-Gaddis/dp/0134444329)
-- **Automate the Boring Stuff with Python** (2nd Edition)
-  - [Free Online](https://automatetheboringstuff.com/) | [Amazon](https://www.amazon.com/Automate-Boring-Stuff-Python-Programming/dp/1593279922)
-
-#### **Advanced Python**
-- **Python Cookbook: Recipes for Mastering Python 3**
-  - [Amazon](https://www.amazon.co.uk/Python-Cookbook-David-Beazley/dp/1449340377)
-- **Effective Python: 90 Specific Ways to Write Better Python** (2nd Edition)
-  - [Amazon](https://www.amazon.com/Effective-Python-Specific-Software-Development/dp/0134853989)
-- **Clean Code in Python**
-  - [Amazon](https://www.amazon.com/Clean-Code-Python-maintainable-efficient/dp/1788835832)
-
-### Courses
-
-#### **Beginner Courses**
-- [Python for Everybody](https://www.coursera.org/specializations/python)
-- [Python 3 Programming](https://www.coursera.org/specializations/python-3-programming)
-
-#### **Advanced Learning**
-- [REST APIs with Flask and Python](https://www.coursera.org/learn/packt-rest-apis-with-flask-and-python-in-2024-i01az) - Professional Flask development
-- [yfinance Documentation](https://ranaroussi.github.io/yfinance/) - Official docs for Yahoo Finance data access in Python
-
-### Algorithms
-
-- [Interactive Python Coding Interview Challenges](https://github.com/donnemartin/interactive-coding-challenges) - Algorithms and data structures
-- [Algorithms: Minimal Examples in Python](https://github.com/keon/algorithms) - Data structures and algorithms
-- [Pygorithm](http://pygorithm.readthedocs.io/en/latest) - Fun way to learn algorithms
-
-### Web Development
-
-#### **FastAPI**
-- [FastAPI Documentation](https://fastapi.tiangolo.com/) - Modern, fast web framework for building APIs
-- [FastAPI Best Practices](https://github.com/zhanymkanov/fastapi-best-practices)
-
-#### **Flask**
-- [REST APIs with Flask and Python](https://www.coursera.org/learn/packt-rest-apis-with-flask-and-python-in-2024-i01az)
-- [Developing RESTful APIs with Python and Flask](https://auth0.com/blog/developing-restful-apis-with-python-and-flask)
-- [Flask and Code Quality](https://flake8.pycqa.org/en/latest/user/error-codes.html)
-
-#### **Django**
-- [Complete Beginner's Guide to Django - Part 1](https://simpleisbetterthancomplex.com/series/2017/09/04/a-complete-beginners-guide-to-django-part-1.html)
-- [Django REST framework Quickstart](https://www.django-rest-framework.org/tutorial/quickstart/)
-
-### Data Science
-
-#### **NumPy**
-- [From Python to NumPy](http://www.labri.fr/perso/nrougier/from-python-to-numpy/)
-- [Exploring Line Lengths in Python Packages](http://jakevdp.github.io/blog/2017/11/09/exploring-line-lengths-in-python-packages)
-
-#### **Matplotlib**
-- [Anatomy of Matplotlib](https://github.com/matplotlib/AnatomyOfMatplotlib)
-
-#### **Data Analysis Projects**
-- [Exploring United States Policing Data](https://blog.patricktriest.com/police-data-python)
-- [Build a Gradebook With pandas](https://realpython.com/pandas-project-gradebook/)
-- [FiveThirtyEight Style Sheet](https://matplotlib.org/stable/gallery/style_sheets/fivethirtyeight.html)
-- [Amazon Product Review Analysis](http://minimaxir.com/2017/01/amazon-spark)
-
-### Automation & Bots
-
-#### **Web Scraping**
-- [Scrapy Tutorial](https://docs.scrapy.org/en/latest/intro/tutorial.html)
-- [Advanced Web Scraping: Bypassing 403 Forbidden](http://sangaline.com/post/advanced-web-scraping-tutorial)
-- [Mastering Python Web Scraping](https://hackernoon.com/mastering-python-web-scraping-get-your-data-back-e9a5cc653d88)
-
-#### **Automation Projects**
-- [Wedding Automation with Twilio and Python](https://www.twilio.com/blog/2017/04/wedding-at-scale-how-i-used-twilio-python-and-google-to-automate-my-wedding.html)
-- [Finding Interesting People on Medium](https://medium.freecodecamp.org/how-i-used-python-to-find-interesting-people-on-medium-be9261b924b0)
-
-#### **Spreadsheets Integration**
-- [Python Excel Tutorial: The Definitive Guide](https://hackernoon.com/python-excel-tutorial-the-definitive-guide-934ee6dd15b0)
-- [Data Analysis with Python in Excel](https://learning.anaconda.cloud/anaconda-certified-data-analysis-with-python-in-excel)
-- [Google Sheets and Python](https://www.youtube.com/watch?v=vISRn5qFrkM)
-
-### Finance & Trading
-
-- [yfinance Documentation](https://ranaroussi.github.io/yfinance/)
-- [Research Backtesting Environments in Python with pandas](https://www.quantstart.com/articles/Research-Backtesting-Environments-in-Python-with-pandas/)
-- [Alpha Vantage API Documentation](https://www.alphavantage.co/documentation/)
-- [Stock Price Data - Python for Finance](https://www.youtube.com/watch?v=2BrpKpWwT2A)
-- [Analyzing Cryptocurrency Markets](https://blog.patricktriest.com/analyzing-cryptocurrencies-python)
-
-### Performance Optimization
-
-- [Million Requests per Second with Python](https://medium.freecodecamp.com/million-requests-per-second-with-python-95c137af319)
-- [Yes, Python is Slow, and I Don't Care](https://hackernoon.com/yes-python-is-slow-and-i-dont-care-13763980b5a1)
-- [Memoization in Python](https://dbader.org/blog/python-memoization)
+The catalog is published at [python.flypython.com](https://python.flypython.com/).