sapphire-telegram
Telegram bot framework — handlers, commands, notification routing, agent dispatch
Source facts
- Repository
- arigatoexpress/Sapphire
- Last source activity
- July 29, 2026 at 15:50
- Detected SKILL.md language
- English
- Stars
- 1
- Forks
- 0
Install options
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Review the source files
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
File Explorer
17 filesShowing SKILL.md
SKILL.md
Source instructions · Read-only preview- name
- sapphire-telegram
- description
- Telegram bot framework — handlers, commands, notification routing, agent dispatch
- type
- library
- runtime
- python
- deploy_target
- rari1
- dependencies
- ["sapphire-core"]
- entry_point
- src/sapphire_telegram/bot.py
- test_command
- pytest tests/
# sapphire.telegram
Shared Telegram bot framework used by control-plane and lighter services. Handles bot lifecycle, command routing, and outbound notifications.
## Key Modules
- `bot.py` — Bot init, webhook/polling mode switch, startup validator
- `handlers.py` — Command handlers: /status, /pnl, /deploy, /task, /alert
## Usage
```python
from sapphire_telegram.bot import SapphireBot
bot = SapphireBot(token=os.getenv("TELEGRAM_BOT_TOKEN"))
bot.run_polling()
```
## Notification Routing
Outbound notifications are tagged before send:
- `priority:p0` → immediate push, bypass quiet hours
- `type:trading` → trading channel
- `agent:kimi` → Kimi status channel
## Deploy Notes
- Runs on rari1 as part of control-plane service
- Bot token in Secret Manager: `sapphire-telegram-bot-token`
- Webhook URL (Cloud Run): `https://pm.sapphirealpha.xyz/telegram/webhook`
View on GitHub