|
1 | 1 | # Python Project Radar |
2 | 2 |
|
3 | 3 | FlyPython recommends current Python projects only after a maintainer reviews |
4 | | -the project’s source, maintenance state, license, documentation, release |
| 4 | +the project's source, maintenance state, license, documentation, release |
5 | 5 | history, and practical user value. This directory is intentionally not seeded |
6 | 6 | with unverified or AI-generated recommendations. |
7 | 7 |
|
| 8 | +Each reviewed project is one YAML file in this directory (`<id>.yml`). The |
| 9 | +table below is generated from those files by `tools/render_readmes.py`; edit |
| 10 | +the YAML, never the table. `radar.json` (repository root) is the |
| 11 | +machine-readable export for consumers who pin a repository commit. |
| 12 | + |
| 13 | +`ai_familiarity` records whether mainstream model training data covers the |
| 14 | +project and its current API — see `docs/CURATION_POLICY.md` for the grading |
| 15 | +rules. |
| 16 | + |
8 | 17 | ## Reviewed Projects Radar |
9 | 18 |
|
10 | | -| Project | Category | Status | Primary Rationale & Evidence | Risk / Safety Note | Review Date | |
11 | | -| --- | --- | --- | --- | --- | --- | |
12 | | -| [uv](https://github.com/astral-sh/uv) | Tooling & Packaging | `stable` | Extremely fast Cargo/Rust-based package and project manager. Replaces pip, pip-tools, venv, and pyenv with lockfile determinism. | Actively maintained by Astral; requires trusting binary wheels. | 2026-09-02 | |
13 | | -| [ruff](https://github.com/astral-sh/ruff) | Code Quality | `stable` | 10-100x faster linter and formatter. Unifies Flake8, Black, isort, and pyupgrade rules into a single config. | Drop-in Black compatibility; syntax parse differences are rare. | 2026-09-02 | |
14 | | -| [fastapi](https://github.com/fastapi/fastapi) | Web & APIs | `stable` | Production-standard ASGI framework with automatic OpenAPI docs, Pydantic validation, and dependency injection. | Ensure background tasks handle errors properly; use async endpoints responsibly. | 2026-09-02 | |
15 | | -| [pydantic-ai](https://github.com/pydantic/pydantic-ai) | AI Agents | `rising` | Model-agnostic agent framework prioritizing type-safe structured outputs, dependency injection, and testability. | Rapidly evolving API surface; pin minor versions. | 2026-09-02 | |
16 | | -| [instructor](https://github.com/jxnl/instructor) | AI Tools | `stable` | Production standard for extracting structured JSON from LLMs using Pydantic models with retry validation. | Requires API keys for target LLM providers. | 2026-09-02 | |
17 | | -| [polars](https://github.com/pola-rs/polars) | Data & Pipelines | `stable` | High-performance DataFrame library built in Rust on Apache Arrow with lazy query optimization. | API differs from pandas; memory layout is columnar. | 2026-09-02 | |
18 | | -| [marimo](https://github.com/marimo-team/marimo) | Interactive Notebooks | `rising` | Reactive, pure-Python notebook stored as standard executable `.py` files with deterministic state execution. | Requires modern browser environment; replaces Jupyter workflow. | 2026-09-02 | |
| 19 | +<!-- radar-index:start --> |
| 20 | +<!-- Generated by tools/render_readmes.py; edit catalog/projects/*.yml instead. --> |
| 21 | +| Project | Category | Status | AI familiarity | Why it matters | When not to use / Risk | Reviewed | |
| 22 | +| --- | --- | --- | --- | --- | --- | --- | |
| 23 | +| [fastapi](https://github.com/fastapi/fastapi)<br><sub>fastapi/fastapi · MIT</sub> | Web & APIs | `stable` | AI: high | Production-standard ASGI framework with automatic OpenAPI docs, Pydantic validation, and dependency injection. | For non-HTTP services, or teams standardized on Django's bundled ORM/admin stack.<br>**Risk:** Ensure background tasks handle errors properly and use async endpoints responsibly; blocking calls inside async routes degrade the whole service. | 2026-09-02 | |
| 24 | +| [instructor](https://github.com/jxnl/instructor)<br><sub>jxnl/instructor · MIT</sub> | AI Tools | `stable` | AI: medium | Production standard for extracting structured JSON from LLMs using Pydantic models with retry validation. | When your provider already enforces structured outputs natively and you need nothing beyond it.<br>**Risk:** Requires API keys for the target LLM providers; retry loops add latency and token cost. | 2026-09-02 | |
| 25 | +| [marimo](https://github.com/marimo-team/marimo)<br><sub>marimo-team/marimo · Apache-2.0</sub> | Interactive Notebooks | `rising` | AI: low | Reactive, pure-Python notebook stored as standard executable .py files with deterministic state execution. | When your workflow depends on Jupyter-only extensions, or kernel-state debugging is central to your process.<br>**Risk:** Requires a modern browser environment and replaces the Jupyter workflow rather than extending it. | 2026-09-02 | |
| 26 | +| [polars](https://github.com/pola-rs/polars)<br><sub>pola-rs/polars · MIT</sub> | Data & Pipelines | `stable` | AI: medium | High-performance DataFrame library built in Rust on Apache Arrow with lazy query optimization. | When your pipeline leans on the pandas ecosystem (accessors, narrow libraries) or you need index-heavy semantics.<br>**Risk:** API differs from pandas and memory layout is columnar; budget migration time rather than assuming drop-in parity. | 2026-09-02 | |
| 27 | +| [pydantic-ai](https://github.com/pydantic/pydantic-ai)<br><sub>pydantic/pydantic-ai · MIT</sub> | AI Agents | `rising` | AI: low | Model-agnostic agent framework prioritizing type-safe structured outputs, dependency injection, and testability. | When you need a stable long-lived API surface today, or heavy multi-agent orchestration features.<br>**Risk:** Rapidly evolving API surface; pin minor versions and re-run your evals on every upgrade. | 2026-09-02 | |
| 28 | +| [ruff](https://github.com/astral-sh/ruff)<br><sub>astral-sh/ruff · MIT</sub> | Code Quality | `stable` | AI: high | 10-100x faster linter and formatter that unifies Flake8, Black, isort, and pyupgrade rules in a single configuration. | When a project depends on plugin ecosystems (e.g. Flake8 plugins) that have no Ruff equivalent yet.<br>**Risk:** Drop-in Black compatibility; rare syntax-parsing differences surface on unusual code bases. | 2026-09-02 | |
| 29 | +| [uv](https://github.com/astral-sh/uv)<br><sub>astral-sh/uv · MIT OR Apache-2.0</sub> | Tooling & Packaging | `stable` | AI: medium | Extremely fast Rust-based package and project manager that replaces pip, pip-tools, venv, and pyenv with lockfile determinism. | When you must pin an existing pip-tools or Poetry workflow, or in air-gapped environments without wheel mirrors.<br>**Risk:** Actively maintained by Astral; relies on prebuilt binary wheels, so supply-chain review applies on upgrade. | 2026-09-02 | |
| 30 | +<!-- radar-index:end --> |
| 31 | + |
| 32 | +## Machine-readable data |
| 33 | + |
| 34 | +- `radar.json` — deterministic export of every reviewed project (pinned by |
| 35 | + website consumers together with `catalog.json`). |
| 36 | +- `candidates.json` — output of `tools/radar_scan.py`; raw discovery |
| 37 | + candidates with **no descriptions and no status** until a human reviews |
| 38 | + them. |
19 | 39 |
|
20 | 40 | ## Submission & Lifecycle States |
21 | 41 |
|
22 | 42 | Use the [project proposal form](../../.github/ISSUE_TEMPLATE/project-proposal.yml) |
23 | 43 | to suggest a project. An accepted record will use one of these lifecycle states: |
24 | | -`new`, `rising`, `stable`, `major-update`, `experimental`, or `archived`. “New” |
| 44 | +`new`, `rising`, `stable`, `major-update`, `experimental`, or `archived`. "New" |
25 | 45 | describes a recent reviewed discovery, not an unverified quality claim. |
0 commit comments