# theolivenbaum/PaddleOCR — health index 53/100 (Moderate)

> Inspection of the public repository theolivenbaum/PaddleOCR by inspect.software. It holds a health index of 53 out of 100, placing it in the Moderate band. The index is a signal derived from publicly visible practice, not a warranty, a security audit, or an endorsement, and it is independent of payment.

- Repository: https://github.com/theolivenbaum/PaddleOCR
- Report page: https://inspect.software/software/theolivenbaum/PaddleOCR
- Full JSON report: https://inspect.software/api/repositories/theolivenbaum/PaddleOCR/report
- Badge: https://raw.githubusercontent.com/inspect-software/badges/main/v1/t/theolivenbaum/PaddleOCR.svg
- Inspected: 2026-08-28
- Methodology: metrics 2.10.0, report schema 0.34.0 (https://inspect.software/methodology.md)

## Category summary

| Category | Weight | Index | Band |
|---|---|---|---|
| Vitality | 21% | 56/100 | Moderate |
| Community & Adoption | 17% | 12/100 | Critical |
| Sustainability & Governance | 23% | 85/100 | Excellent |
| Engineering Quality | 19% | 46/100 | Weak |
| Security | 16% | 40/100 | Weak |
| AI Readiness | 4% | 89/100 | Excellent |

The weighted overall 52 is calibrated to 53 on the published index scale (record calibration 2026-08-02).

## Repository facts

| Field | Value |
|---|---|
| Description | Turn any PDF or image document into structured data for your AI. A powerful, lightweight OCR toolkit that bridges the gap between images/PDFs and LLMs. Supports 100+ languages. |
| Classification | mcp-server, cli, mobile, library |
| Homepage | https://www.paddleocr.com |
| Primary language | Python |
| License | Apache-2.0 |
| Stars | 0 |
| Forks | 0 |
| Created | 2026-08-27 |
| Last push | 2026-08-27 |
| Commits (last year) | 253 |
| Bus factor | 4 |
| Fork | yes |

## Published packages

| Registry | Package | Latest | Monthly downloads |
|---|---|---|---|
| pypi | paddleocr | 3.7.0 | 2,529,617 |
| pypi | paddleocr_mcp | 0.8.5 | 7,399 |
| pypi | langchain-paddleocr | 0.2.2 | 92 |

## Vitality — 56/100 (Moderate)

Is the project alive — is code being written and are releases shipping? Weight: 21% of the overall index.

### Development activity — 92/100 (Excellent)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Push recency | met | 36 / 36 | last push 0 days ago |
| Commit cadence | partial | 29.1 / 36 | 42/52 weeks with commits |
| Commit volume | met | 18 / 18 | 253 commits in the last year |
| OpenSSF Scorecard: Maintained | excluded | 0 / 10 | OpenSSF Scorecard unavailable |

### Release discipline — 1/100 (Critical)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Ships releases | not met | 0 / 27 | no releases published |
| Release recency | not met | 0 / 36 | no releases |
| Release cadence | not met | 0 / 27 | no releases |
| OpenSSF Scorecard: Signed-Releases | excluded | 0 / 10 | OpenSSF Scorecard unavailable |

### Abandonment — 100/100 (Exceptional)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Project is still maintained | met | 100 / 100 | maintenance record not established from the collected data |

## Community & Adoption — 12/100 (Critical)

Does the project have users, downloads, attention, and a welcoming setup for contributors? Weight: 17% of the overall index.

### Popularity & adoption — 1/100 (Critical)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Stars | not met | 0 / 60 | 0 stars |
| Forks | not met | 0 / 25 | 0 forks |
| Watchers | not met | 0 / 15 | 0 watchers |

### Community health — 25/100 (At Risk)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| README | not met | 0 / 22.5 | — |
| License | met | 22.5 / 22.5 | recognized license (Apache-2.0) |
| CONTRIBUTING guide | not met | 0 / 18 | — |
| Code of conduct | not met | 0 / 13.5 | — |
| Issue template | not met | 0 / 7.2 | — |
| PR template | not met | 0 / 6.3 | — |

## Sustainability & Governance — 85/100 (Excellent)

Will the project survive its people — bus factor, responsiveness, who backs it, and package upkeep? Weight: 23% of the overall index.

### Maintainer resilience (bus factor) — 83/100 (Excellent)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Bus factor | partial | 43.2 / 54 | 4 contributor(s) cover half of all commits |
| Commit distribution | partial | 18.2 / 22.5 | top contributor authored 19% of commits |
| Contributor breadth | met | 13.5 / 13.5 | 99 contributors |
| OpenSSF Scorecard: Contributors | excluded | 0 / 10 | OpenSSF Scorecard unavailable |

### Issue & PR responsiveness — 100/100 (Exceptional)

Excluded from scoring (no data or not applicable): Issue resolution. Remaining weights renormalized.

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Issue resolution | excluded | 0 / 42 | no issues or no data |
| PR acceptance | met | 30 / 30 | 3/3 decided PRs merged |
| Newcomer PR acceptance | met | 13 / 13 | 3/3 first-time contributors' PRs merged in 30d |
| OpenSSF Scorecard: Code-Review | excluded | 0 / 15 | OpenSSF Scorecard unavailable |

### Ownership & stewardship — 61/100 (Moderate)

Excluded from scoring (no data or not applicable): Verified domain. Remaining weights renormalized.

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Ownership backing | partial | 10 / 30 | personal (user) account |
| Verified domain | excluded | 0 / 20 | not applicable to user accounts |
| Owner reach | partial | 13.7 / 25 | 79 followers of theolivenbaum |
| Track record | met | 25 / 25 | 514 public repos, account ~11 yr old |

### Package maintenance — 100/100 (Exceptional)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Published & resolvable | met | 25 / 25 | 1 package(s) on pypi |
| Publish recency | met | 35 / 35 | latest publish 78 days ago |
| Version history | met | 20 / 20 | 13 published versions |
| Not deprecated | met | 20 / 20 | active, not deprecated or yanked |

## Engineering Quality — 46/100 (Weak)

Are baseline engineering and documentation practices in place? Weight: 19% of the overall index.

### Engineering practices — 50/100 (Moderate)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| CI workflows | not met | 0 / 24 | — |
| Tests present | met | 24 / 24 | — |
| Linter config | met | 16 / 16 | eslint.config.js, langchain-paddleocr/pyproject.toml ([tool.ruff]) |
| Pre-commit hooks | not met | 0 / 9.6 | — |
| .editorconfig | not met | 0 / 6.4 | — |
| OpenSSF Scorecard: CI-Tests | excluded | 0 / 20 | OpenSSF Scorecard unavailable |

### Documentation — 40/100 (Weak)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| README | not met | 0 / 30 | — |
| Documentation directory | met | 25 / 25 | — |
| Documentation / homepage site | met | 15 / 15 | https://www.paddleocr.com |
| Repository description | not met | 0 / 10 | — |
| Topics | not met | 0 / 10 | — |
| Wiki | not met | 0 / 10 | — |

## Security — 40/100 (Weak)

Are visible security and supply-chain practices strong, with no malicious dependency and no unresolved high-risk jurisdiction exposure? Weight: 16% of the overall index.

### Security posture — 25/100 (At Risk)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Security policy (SECURITY.md) | not met | 0 / 30 | — |
| Dependabot config | not met | 0 / 25 | — |
| Dependency lockfiles | met | 25 / 25 | package-lock.json, uv.lock |
| CodeQL workflow | not met | 0 / 20 | — |

### Dependency advisories — 100/100 (Exceptional)

Excluded from scoring (no data or not applicable): No advisories left outstanding. Remaining weights renormalized. Matched the pypi:paddleocr@3.7.0 runtime dependency closure — what installing the published package pulls in — 58 packages. Reachability is not analyzed.

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Direct dependencies free of known advisories | met | 35 / 35 | no direct dependency carries a known advisory |
| Indirect dependencies free of known advisories | met | 25 / 25 | no indirect dependency carries a known advisory |
| No advisories left outstanding | excluded | 0 / 40 | no advisory carries a publication date |

### Malicious dependencies — 100/100 (Exceptional)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| No dependency reported as a malicious package | met | 100 / 100 | no dependency is reported as a malicious package |

### High-Risk Jurisdiction Exposure — 100/100 (Exceptional)

Only high-confidence self-published location evidence affects this multiplier. Ambiguous matches are review-only; country evidence is not proof of nationality, citizenship, legal registration, malicious intent, or sanctions status.

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Policy exposure multiplier | met | 100 / 100 | no confirmed policy-scope location match |

## AI Readiness — 89/100 (Excellent)

How well is the repo equipped to be developed and maintained with AI coding agents? Carries a deliberately small weight: agent tooling is a real maintenance signal, but its absence must never gate the top of the scale (calibration saturates at raw 91, so 100/100 remains reachable with AI Readiness at zero).

### Agent context & guidance — 85/100 (Excellent)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Agent instructions | met | 45 / 45 | CLAUDE.md |
| Machine-readable docs (llms.txt) | not met | 0 / 15 | — |
| Legible commit history | met | 40 / 40 | 95 of 100 human commits state their intent (structured subject or explanatory body) |

### Verify loop (build / test / typecheck) — 91/100 (Excellent)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| One-command bootstrap | met | 18 / 18 | deploy/avh/Makefile, deploy/lite/Makefile, langchain-paddleocr/Makefile |
| Automated tests | met | 22 / 22 | — |
| Lint / format config | met | 11 / 11 | eslint.config.js, langchain-paddleocr/pyproject.toml ([tool.ruff]) |
| Static type checking | met | 11 / 11 | api_sdk/typescript/tsconfig.json, langchain-paddleocr/langchain_paddleocr/py.typed, mcp_server/paddleocr_mcp/py.typed, paddleocr-js/apps/demo/tsconfig.json, paddleocr-js/packages/core/tsconfig.json, paddleocr-js/tsconfig.json |
| Reproducible environment | met | 10 / 10 | Dockerfile, lockfile |
| Demonstrated agent practice | met | 10 / 10 | 45 of the last 100 commits agent-authored or agent-credited |
| Automated maintenance | not met | 0 / 8 | no automated dependency updates observed |
| OpenSSF Scorecard: Pinned-Dependencies | excluded | 0 / 10 | OpenSSF Scorecard unavailable |

### Code legibility for models — 82/100 (Excellent)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Type-checkable code | partial | 27 / 45 | Python with type-check config (api_sdk/typescript/tsconfig.json, langchain-paddleocr/langchain_paddleocr/py.typed, mcp_server/paddleocr_mcp/py.typed, paddleocr-js/apps/demo/tsconfig.json, paddleocr-js/packages/core/tsconfig.json, paddleocr-js/tsconfig.json) |
| Manageable file sizes | partial | 54.7 / 55 | 6/1053 source files over 60KB |

### Machine-readable interfaces — 100/100 (Exceptional)

Excluded from scoring (no data or not applicable): API schema (OpenAPI/GraphQL/proto). Remaining weights renormalized.

| Criterion | Status | Points | Detail |
|---|---|---|---|
| API schema (OpenAPI/GraphQL/proto) | excluded | 0 / 40 | not applicable to this kind of software |
| MCP server | met | 20 / 20 | — |
| Runnable examples | met | 40 / 40 | examples |

## Collection warnings

- Community profile unavailable
- pypi package 'paddleocr' points at a different repository (https://github.com/PaddlePaddle/PaddleOCR.git); excluded from ecosystem scoring
- pypi package 'langchain-paddleocr' points at a different repository (https://github.com/PaddlePaddle/PaddleOCR); excluded from ecosystem scoring
- GitHub dependency-graph SBOM unavailable (404); the dependency graph may be disabled for this repository
- OpenSSF Scorecard did not return a usable result (killed by SIGKILL — most likely the container's memory limit; 2026/08/28 10:02:59 Warning: PATs stored in env variables GITHUB_AUTH_TOKEN and GITHUB_TOKEN differ. Scorecard will use the former.); skipping Scorecard checks

## What this report is

inspect.software measures public repositories against a single published, versioned methodology and reports the result as a 1–100 health index. Findings are signals derived from what is visible in public repository data — they are not a security audit, a warranty, or an endorsement, and no result depends on payment.

- Methodology, formulas and weights: https://inspect.software/methodology.md
- What a result does and does not claim: https://inspect.software/wiki/signals-not-warranties.md
- Rating bands: https://inspect.software/wiki/scoring-bands.md
- Corrections: https://inspect.software/contact.md
- Index of all documents: https://inspect.software/llms.txt