Skip to content

chore(meta): rich PyPI metadata + README freshness (discoverability) - #29

Merged
ggalancs merged 1 commit into
mainfrom
chore/discoverability-metadata
May 24, 2026
Merged

chore(meta): rich PyPI metadata + README freshness (discoverability)#29
ggalancs merged 1 commit into
mainfrom
chore/discoverability-metadata

Conversation

@ggalancs

Copy link
Copy Markdown
Owner

Wins de descubribilidad/SEO inmediatos (riesgo cero, validados con twine check).

Problema

La ficha de PyPI de hfl renderizaba vacía: sin readme, keywords, classifiers ni project.urls. Resultado: no rankea en búsqueda/categorías de PyPI y la página no muestra descripción.

Cambios

  • readme = "README.md" → el README se renderiza en PyPI (markdown).
  • keywords (huggingface, llm, ollama, gguf, local-llm, llama-cpp, mlx, vllm, inference, openai-api, self-hosted, ai, transformers, model-serving).
  • classifiers (AI, audiencias dev/research, Python 3.10–3.13, Console, FastAPI, OS Independent).
  • [project.urls] — Homepage (docs), Repository, Issues, Changelog (enlaces en la sidebar de PyPI).
  • authors.
  • README: madurez Alpha (v0.12.2)Beta (v0.13.0) (estaba obsoleto y ahuyentaba).

Además (fuera del PR, ya aplicado en settings): GitHub About con homepage → sitio de docs y topics ampliados (gguf, llama-cpp, mlx, vllm, inference, self-hosted, ai, model-serving, transformers, privacy).

Verificación

python -m build + twine check dist/*PASSED (wheel + sdist); METADATA con 14 keywords, 13 classifiers, 5 URLs, text/markdown. Suite verde.

Surtirá efecto en la próxima publicación a PyPI (la 0.13.0 ya publicada se queda con la ficha vacía; la siguiente versión tendrá la ficha completa).

🤖 Generated with Claude Code

The PyPI page rendered empty (no readme/keywords/classifiers/URLs), so the
package didn't surface in PyPI search or category browsing and showed no
description. Fix the packaging metadata so the next release has a full page:

- readme = "README.md" -> the README renders on PyPI (text/markdown).
- keywords (huggingface, llm, ollama, gguf, local-llm, llama-cpp, mlx,
  vllm, inference, openai-api, self-hosted, ...).
- classifiers (AI topic, audiences, Python 3.10-3.13, console, FastAPI).
- [project.urls]: Homepage (docs site), Repository, Issues, Changelog.
- authors.

README: maturity Alpha (v0.12.2) -> Beta (v0.13.0) (was stale + scary).

GitHub "About" (set out-of-band): homepage -> docs site, topics expanded.
Validated with `python -m build` + `twine check` (both PASS).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@ggalancs
ggalancs merged commit d8bcb2b into main May 24, 2026
12 checks passed
@ggalancs
ggalancs deleted the chore/discoverability-metadata branch May 24, 2026 22:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant