Publish birdcage-tui to PyPI, document TUI extras
Bumped version to 2026.02.17, added classifiers/keywords/URLs. Documented camera extra (Pillow + astropy) in CLAUDE.md. Added TUI section with uvx usage and extras table.
This commit is contained in:
parent
5a26dce075
commit
3ccec3be10
3 changed files with 56 additions and 5 deletions
36
CLAUDE.md
36
CLAUDE.md
|
|
@ -768,6 +768,42 @@ This captures 8 SVG + 8 PNG screenshots plus a 2×3 collage:
|
|||
or screen content. The script populates Craft search results and tracking state
|
||||
directly via widget API for deterministic screenshots.
|
||||
|
||||
## TUI
|
||||
|
||||
| Property | Value |
|
||||
|----------|-------|
|
||||
| PyPI | [`birdcage-tui`](https://pypi.org/project/birdcage-tui/) |
|
||||
| Source | `tui/src/birdcage_tui/` |
|
||||
| Entry point | `birdcage_tui.app:main` |
|
||||
| Framework | [Textual](https://textual.textualize.io/) |
|
||||
| Screens | Dashboard (F1), Control (F2), Signal (F3), System (F4), Console (F5), Camera (F6) |
|
||||
|
||||
### Running
|
||||
|
||||
```bash
|
||||
# Published package (from PyPI) — no clone needed
|
||||
uvx birdcage-tui --demo # demo mode, base install
|
||||
uvx birdcage-tui # hardware mode (needs serial port)
|
||||
|
||||
# With camera capture support (Pillow + astropy)
|
||||
uvx --with 'birdcage-tui[camera]' birdcage-tui --demo
|
||||
|
||||
# Local development
|
||||
uv run --directory tui birdcage-tui --demo
|
||||
```
|
||||
|
||||
### Extras
|
||||
|
||||
| Extra | Install | Packages | Purpose |
|
||||
|-------|---------|----------|---------|
|
||||
| *(base)* | `uvx birdcage-tui` | `winegard-birdcage`, `textual` | Full TUI, all screens, demo mode |
|
||||
| `camera` | `uvx --with 'birdcage-tui[camera]' birdcage-tui` | `Pillow>=10.0`, `astropy>=6.0` | F6 camera overlay: JPEG capture frames with annotated demo images (Pillow), FITS export for radio astronomy pipelines (astropy) |
|
||||
|
||||
**Graceful degradation:** The camera screen (F6) works without the `camera` extra — it
|
||||
falls back to writing minimal JPEG headers directly. Pillow adds annotated demo frames
|
||||
and proper image processing; astropy adds FITS file export for integration with DS9,
|
||||
CASA, and other radio astronomy tools.
|
||||
|
||||
## MCP Server
|
||||
|
||||
| Property | Value |
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue