Skip to content

Improve README readability#10

Draft
gary149 wants to merge 5 commits into
huggingface:mainfrom
gary149:improve-readme
Draft

Improve README readability#10
gary149 wants to merge 5 commits into
huggingface:mainfrom
gary149:improve-readme

Conversation

@gary149
Copy link
Copy Markdown

@gary149 gary149 commented Mar 19, 2026

Summary

  • Replaced sentence-long H1 with clean title + tagline
  • Added 3-line quickstart front and center
  • Added "what happens" section explaining the full run pi flow
  • Documented all options: --top N, explicit model arg, Pi arg forwarding
  • Added macOS vs Linux dependency table showing what's auto-installed vs manual
  • Added missing LLAMA_SERVER_TIMEOUT env var
  • Added "good to know" section: server reuse, log location, config cleanup, Esc to cancel

Test plan

  • Verify all documented commands match actual script behavior
  • Check links resolve correctly
  • Render check on GitHub

The old README had a sentence-long title, buried the quickstart, missed
key flags (--top, explicit model), and didn't document auto-install
behavior, server reuse, log location, or LLAMA_SERVER_TIMEOUT.
@gary149 gary149 changed the title Rewrite README for better developer experience Improve README readability Mar 19, 2026
gary149 added 4 commits March 19, 2026 22:58
Reduce from 103 lines / 7 sections to 56 lines / 4 sections.
Remove "How it works" step list, dependencies table, and H3
subsections. Collapse config into a details element. Move
component credits to footer as attribution.
Comment thread README.md
```bash
# install the HF CLI
curl -LsSf https://hf.co/cli/install.sh | bash
# install the hf-agents extension
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

let's mention that hf extensions install hf-agents --force is the workaround to upgrade the extension (we don't have hf extensions upgrade yet but it's planned)

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.

2 participants