Skip to content

feat: Add Linux support (systemd services + faster-whisper voice transcription)#1

Open
UncleTallest wants to merge 2 commits intoseedprod:mainfrom
continuity-bridge:main
Open

feat: Add Linux support (systemd services + faster-whisper voice transcription)#1
UncleTallest wants to merge 2 commits intoseedprod:mainfrom
continuity-bridge:main

Conversation

@UncleTallest
Copy link

This PR adds full Linux parity to the existing macOS setup. No breaking changes -- all macOS behavior is unchanged.

What's added:
systemd/ -- Linux service files equivalent to the existing launchd/ templates:
claude-telegram-bot.service -- runs the bot continuously, restarts on failure, loads .env automatically
claude-daily-brief.service + claude-daily-brief.timer -- scheduled briefings via systemd timer (equivalent to StartCalendarInterval in launchd)
README.md -- full setup instructions including loginctl enable-linger for headless/server installs
telegram-bot.py -- platform detection for voice transcription:

macOS: uses existing mlx-whisper (unchanged)
Linux: uses faster-whisper with WhisperModel("small", device="cpu", compute_type="int8")

Graceful fallback if neither is installed, with platform-appropriate install instructions in the error message

requirements.txt -- clarified the platform split for voice deps with comments
README.md -- Linux instructions added alongside macOS throughout:

Platform support table
systemd setup steps mirroring the launchd steps
Linux log commands (journalctl)
sed one-liner for path substitution in service files
stronger visible warning if ALLOWED_USERS is empty on launch

Tested on: Pop!_OS 24.04, Python 3.12, Claude Code latest

- systemd/: service files for bot and daily briefing, timer for
  scheduling, README with full setup instructions
- telegram-bot.py: platform detection for voice transcription;
  faster-whisper on Linux, mlx-whisper on macOS (Apple Silicon)
- requirements.txt: clarify platform split for voice deps
- README.md: Linux setup instructions alongside macOS, platform
  support table, systemd log commands

No breaking changes. macOS behavior unchanged.
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