Rockachopa/Timmy-time-dashboard
1
0
Fork 2
Code Issues 7 Pull Requests Actions Packages Projects Releases Wiki Activity

[claude] Document and validate AirLLM Apple Silicon requirements (#1284) #1298

Merged
claude merged 1 commits from claude/issue-1284 into main 2026-03-24 01:52:17 +00:00
Conversation 0 Commits 1 Files Changed 5 +178 -3
claude commented 2026-03-24 01:51:52 +00:00
Collaborator
Copy Link

Fixes #1284

Changes

  • README.md: Added System Requirements section covering AirLLM (Apple Silicon M1–M4, 16 GB RAM min, ~15 GB disk) and Ollama (any OS, 8 GB RAM) paths with explicit auto-fallback note
  • config.py: Added "airllm" to timmy_model_backend Literal — the value was documented in README/.env.example but was an invalid pydantic setting
  • agent.py: Added explicit AirLLM import guard in create_timmy() — logs a warning and falls back to Ollama on non-Apple-Silicon hardware or when airllm package is not installed
  • .env.example: Expanded TIMMY_MODEL_BACKEND comment with hardware specs and install instructions for each valid value
  • tests/unit/test_airllm_backend.py: New test file with 9 unit tests covering is_apple_silicon() detection and graceful degradation on Intel/Linux and missing-package scenarios

Test plan

  • tox -e unit passes (507 tests)
Fixes #1284 ## Changes - **README.md**: Added `System Requirements` section covering AirLLM (Apple Silicon M1–M4, 16 GB RAM min, ~15 GB disk) and Ollama (any OS, 8 GB RAM) paths with explicit auto-fallback note - **config.py**: Added `"airllm"` to `timmy_model_backend` Literal — the value was documented in README/.env.example but was an invalid pydantic setting - **agent.py**: Added explicit AirLLM import guard in `create_timmy()` — logs a warning and falls back to Ollama on non-Apple-Silicon hardware or when `airllm` package is not installed - **.env.example**: Expanded `TIMMY_MODEL_BACKEND` comment with hardware specs and install instructions for each valid value - **tests/unit/test_airllm_backend.py**: New test file with 9 unit tests covering `is_apple_silicon()` detection and graceful degradation on Intel/Linux and missing-package scenarios ## Test plan - [x] `tox -e unit` passes (507 tests)
claude added 1 commit 2026-03-24 01:51:52 +00:00
chore: document and validate AirLLM Apple Silicon requirements
Some checks failed
Tests / lint (pull_request) Failing after 11s
Details
Tests / test (pull_request) Has been skipped
Details
7e87dbaa10 
- Add System Requirements section to README.md covering AirLLM
  (Apple Silicon M1-M4, 16 GB RAM, ~15 GB disk) and Ollama (any OS,
  8 GB RAM) paths with an explicit fallback note
- Add "airllm" to timmy_model_backend Literal in config.py so the
  setting is a valid pydantic value (was previously undocumented)
- Add AirLLM import guard in create_timmy(): logs a warning and falls
  back to Ollama on non-Apple-Silicon or when airllm is not installed
- Expand .env.example TIMMY_MODEL_BACKEND comment with hardware specs
  and install instructions
- Add tests/unit/test_airllm_backend.py — 9 tests covering
  is_apple_silicon() detection and airllm graceful degradation on
  Intel/Linux and missing-package paths

Fixes #1284

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
claude merged commit 00ef4fbd22 into main 2026-03-24 01:52:17 +00:00
claude deleted branch claude/issue-1284 2026-03-24 01:52:17 +00:00
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
Clear labels
222-epic
Workshop: Timmy as Presence (Epic #222)
 actionable
Has a concrete code/config task extracted
 assigned-claude
Issue currently assigned to Claude agent — do not assign to another agent
 assigned-gemini
Issue currently assigned to Gemini agent — do not assign to another agent
 assigned-groq
assigned-kimi
Issue currently assigned to Kimi agent — do not assign to another agent
 assigned-manus
Issue currently assigned to Manus agent — do not assign to another agent
 claude-ready
consolidation
Part of a consolidation epic
 deprioritized
Keep open but not blocking P0 work
 deprioritized
Keep open but not blocking P0 work
 duplicate
Duplicate of another issue
 gemini-review
Auto-generated by Gemini, needs relevance review
 groq-ready
harness
Core product: agent framework, heartbeat, inference, memory
 heartbeat
Harness: Agent heartbeat loop
 inference
Harness: Inference and model routing
 infrastructure
Supporting stage: dashboard, CI/CD, deployment, DNS
 kimi-ready
Scoped and ready for Kimi to pick up
 memory-session
Harness: Memory and session crystallization
 morrowind
Harness: Morrowind embodiment
 needs-design
Needs architectural design before implementation
 needs-extraction
Philosophy with unextracted engineering work
 p0-critical
Priority 0: Must fix now
 p1-important
Priority 1: Important, next sprint
 p2-backlog
Priority 2: Backlog, do when time permits
 philosophy
Philosophical foundation — informs architecture decisions
 rejected-direction
Closed: rejected or superseded direction
 seed:know-purpose
Three Seeds: KNOW YOUR PURPOSE
 seed:serve-real
Three Seeds: SERVE THE REAL
 seed:tell-truth
Three Seeds: TELL THE TRUTH
 sovereignty
Harness: Sovereignty stack
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
Timmy claude grok groq kimi manus perplexity Rockachopa
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Rockachopa/Timmy-time-dashboard#1298
Delete Branch "claude/issue-1284"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?