Skip to content

Initial README edits - #2

Merged
tyrwh merged 2 commits into
devfrom
tyr_suggestions
Aug 19, 2026
Merged

tyrwh merged 2 commits into
devfrom
tyr_suggestions

Conversation

@tyrwh

@tyrwh tyrwh commented Aug 19, 2026

Copy link
Copy Markdown
Contributor

First-round edits to README, prior to attempting installation

tyrwh added 2 commits July 31, 2026 09:59
First-round edits to README, prior to attempting installation
@tyrwh
tyrwh merged commit e7904eb into dev Aug 19, 2026
0 of 2 checks passed
ackermanar added a commit that referenced this pull request Sep 21, 2026
Ported from main (fbb3c09) onto dev at e7904eb.

Agent instructions and docs
- AGENTS.md: public agent guide, the single source of truth; CLAUDE.md
  imports it. docs/faq.md: human FAQ, linked from the README.
- .gitignore: commit CLAUDE.md and AGENTS.md; ignore *.local.md.
- README, FAQ, AGENTS: Git LFS is an install prerequisite (a clone made
  without it yields a 134-byte pointer stub, not the model), RF-DETR arrives
  with the clone, and `mats fetch-weights` is the repair path. Repair uses
  `git lfs pull --exclude=weights/birefnet_leaf.pth`, which stays RF-DETR-only
  whether or not .lfsconfig's fetchexclude is active.
- README: reconciled with the restructure from PR #2; its headings and TOC are
  kept, and the hand-edited doctor/fetch paragraph is preserved verbatim.

Also carried over from fbb3c09 (app work, unrelated to the docs)
- src/mats/app/Home.py, branding.py, src/mats/core.py, pyproject.toml,
  tests/test_home_app.py

Known and not addressed here
- .lfsconfig has fetchexclude commented out on dev, so a clone now fetches
  BiRefNet (2.65 GB) as well as RF-DETR.
- tests/test_weights.py::test_status_missing_for_excluded_checkout_pointer
  already fails on dev before this commit (message reworded in PR #2).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
ackermanar added a commit that referenced this pull request Sep 21, 2026
* Initial README edits

First-round edits to README, prior to attempting installation

* changing git-lfs calls and .lfsignore to get desired download behavior for larger birefnet weights

* user agents/claude.md for chatbot interaction

Ported from main (fbb3c09) onto dev at e7904eb.

Agent instructions and docs
- AGENTS.md: public agent guide, the single source of truth; CLAUDE.md
  imports it. docs/faq.md: human FAQ, linked from the README.
- .gitignore: commit CLAUDE.md and AGENTS.md; ignore *.local.md.
- README, FAQ, AGENTS: Git LFS is an install prerequisite (a clone made
  without it yields a 134-byte pointer stub, not the model), RF-DETR arrives
  with the clone, and `mats fetch-weights` is the repair path. Repair uses
  `git lfs pull --exclude=weights/birefnet_leaf.pth`, which stays RF-DETR-only
  whether or not .lfsconfig's fetchexclude is active.
- README: reconciled with the restructure from PR #2; its headings and TOC are
  kept, and the hand-edited doctor/fetch paragraph is preserved verbatim.

Also carried over from fbb3c09 (app work, unrelated to the docs)
- src/mats/app/Home.py, branding.py, src/mats/core.py, pyproject.toml,
  tests/test_home_app.py

Known and not addressed here
- .lfsconfig has fetchexclude commented out on dev, so a clone now fetches
  BiRefNet (2.65 GB) as well as RF-DETR.
- tests/test_weights.py::test_status_missing_for_excluded_checkout_pointer
  already fails on dev before this commit (message reworded in PR #2).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

---------

Co-authored-by: tyrwh <twiesnerhanks@ufl.cornell.edu>
Co-authored-by: A.J. Ackerman <aja294@cornell.edu>
Co-authored-by: Claude Sonnet 5 <noreply@anthropic.com>
ackermanar added a commit that referenced this pull request Sep 23, 2026
* Initial README edits

First-round edits to README, prior to attempting installation

* changing git-lfs calls and .lfsignore to get desired download behavior for larger birefnet weights

* user agents/claude.md for chatbot interaction

Ported from main (fbb3c09) onto dev at e7904eb.

Agent instructions and docs
- AGENTS.md: public agent guide, the single source of truth; CLAUDE.md
  imports it. docs/faq.md: human FAQ, linked from the README.
- .gitignore: commit CLAUDE.md and AGENTS.md; ignore *.local.md.
- README, FAQ, AGENTS: Git LFS is an install prerequisite (a clone made
  without it yields a 134-byte pointer stub, not the model), RF-DETR arrives
  with the clone, and `mats fetch-weights` is the repair path. Repair uses
  `git lfs pull --exclude=weights/birefnet_leaf.pth`, which stays RF-DETR-only
  whether or not .lfsconfig's fetchexclude is active.
- README: reconciled with the restructure from PR #2; its headings and TOC are
  kept, and the hand-edited doctor/fetch paragraph is preserved verbatim.

Also carried over from fbb3c09 (app work, unrelated to the docs)
- src/mats/app/Home.py, branding.py, src/mats/core.py, pyproject.toml,
  tests/test_home_app.py

Known and not addressed here
- .lfsconfig has fetchexclude commented out on dev, so a clone now fetches
  BiRefNet (2.65 GB) as well as RF-DETR.
- tests/test_weights.py::test_status_missing_for_excluded_checkout_pointer
  already fails on dev before this commit (message reworded in PR #2).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

* tests: skip home app tests without numpy

* weights: restore optional BiRefNet LFS fetch

* docs: correct explicit BiRefNet LFS pull

* fixed dependency light ci

* Update README.md (#5)

* fixed contradicotry documentation and markdown

* fixed contradicotry documentation in .md files and agents

---------

Co-authored-by: Tyr Wiesner-Hanks <twiesnerhanks@ufl.edu>
Co-authored-by: tyrwh <twiesnerhanks@ufl.cornell.edu>
Co-authored-by: Claude Sonnet 5 <noreply@anthropic.com>
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