📱 BySalim

BySalim is an AI-powered background agent that lets you control your computer via Telegram using plain natural language.

Features

• Natural language commands → the AI maps your words to the right tool automatically
• 40+ built-in tools — system health, screenshots, weather, shell, file management, reminders, volume, clipboard, and more
• 9 AI providers supported out of the box (OpenAI, Anthropic, Groq, Together, NVIDIA, Mistral, Cohere, Zhipu, OpenRouter) — several offer free tiers
• Encrypted config — your API keys and Telegram token are stored with Fernet symmetric encryption
• Dangerous-action confirmation — shell commands and deletes require a tap of ✅ before executing
• No external dependencies beyond stdlib + 3 packages (click, psutil, cryptography)
• Cross-platform — macOS, Linux, Windows

Quick Start

pip install bysalim

bysalim init    # one-time interactive setup (~2 minutes)
bysalim run     # start the agent in the foreground

Background daemon

nohup bysalim run &

Stop / check

bysalim stop
bysalim status
bysalim doctor   # full diagnostic

CLI Reference

Telegram Commands

Or just type anything in natural language!

Natural Language Examples

how's my cpu?
take a screenshot
what's the weather in Paris?
remind me in 30 minutes to call mom
list files in ~/Downloads
show me the contents of /etc/hosts
run df -h
what's my IP?
calculate 12 * (3 + 7)^2
kill process firefox
open https://news.ycombinator.com
check if google.com is reachable

Available Tools

⚠️ = requires confirmation tap before execution

Configuration

Config is stored in:

• Linux: ~/.local/share/bysalim/data/
• macOS: ~/Library/Application Support/bysalim/data/
• Windows: %APPDATA%\bysalim\data\

The API key and Telegram token are encrypted at rest using a Fernet key stored at data/.enc_key (permissions: 600).

Requirements

• Python 3.10+
• click, psutil, cryptography (auto-installed by bysalim init)
• A Telegram bot token (free, from @BotFather)
• An API key for your chosen AI provider

License

MIT