Getting Started
Installation
Sentinel AI runs as a Chrome Extension paired with a local scraping engine. This guide covers the full installation for macOS and Windows.
What's Included
Your Sentinel package contains:
| Component | Description |
|---|---|
Extension/ | Chrome Extension UI and control panel |
config_server | WebSocket server connecting Extension to scraper |
telegram_forwarder | Main scraping engine |
tdjson.dylib / .dll | TDLib library for Telegram client |
scraper_config.json | Scraper configuration |
chats_config.json | Chat monitoring configuration |
Keep this folder intact. All files are needed for Sentinel to function.
macOS Installation
Requirements
- macOS 10.15 (Catalina) or newer
- Python 3.x (for authentication GUI)
- Google Chrome
- Valid Sentinel license key
Step-by-Step
1. Run the Installer
- Locate the Sentinel installer in your downloaded package
- Double-click to launch and follow the on-screen instructions
- Once complete, proceed to install the Chrome Extension
2. Install the Chrome Extension
- Open Chrome and navigate to
chrome://extensions/ - Enable Developer mode (toggle top-right)
- Click Load unpacked
- Select the
Extension/folder from your Sentinel package - Note the Extension ID shown under the extension card
3. Configure Telegram API
- Visit https://my.telegram.org/apps
- Log in with your phone number
- Create a new application
- Copy the API ID (number) and API Hash (string)
- Open the Sentinel Extension, then click Credentials
- Paste your API ID and API Hash, then save
4. Activate License
- Open the Sentinel Extension, then click License (key icon)
- Copy your HWID (Hardware ID)
- Enter your license key:
SENT-XXXX-XXXX-XXXX-XXXX - Click Activate License
Windows Installation
Requirements
- Windows 10 or later (64-bit)
- Python 3.x
- Google Chrome
- Valid Sentinel license key
Step-by-Step
1. Run the Installer
- Locate the Sentinel installer in your downloaded package
- Double-click to launch and follow the on-screen instructions
- Once complete, proceed to install the Chrome Extension
2. Install the Chrome Extension
Same process as macOS:
- Chrome, then
chrome://extensions/, then Developer mode, then Load unpacked - Select the
Extension/folder
3. Configure Telegram API
Same process as macOS. Get credentials from my.telegram.org/apps and enter them in the Extension.
4. Activate License
Same process. Copy HWID, enter your SENT-XXXX-XXXX-XXXX-XXXX key.
Updating
When a new version of Sentinel is available:
- Download the latest package from your purchase source
- Replace all files in your Sentinel folder
- Re-run the installer
- Your license and configuration will be preserved
Uninstalling
- Remove the Extension from
chrome://extensions/ - Delete the Sentinel folder