Project PAI (Juno)

A proactive AI companion bot for Telegram designed to respect user attention via a "Gatekeeper" logic.

Features

• Gatekeeper Logic: Checks if the user is "muted" before sending messages.
• Message Stacking: Accumulates messages when muted and delivers a summary upon unmuting.
• Pulse Check: A periodic background job simulating proactive AI behavior.

Setup

1. Install Dependencies

Ensure you have Python installed.

pip install -r requirements.txt

2. Configuration

Create a .env file in the root directory with your Telegram credentials:

BOT_TOKEN=your_bot_token_here
ALLOWED_USER_ID=123456789
OLLAMA_MODEL=llama3.2

• BOT_TOKEN: Obtained from BotFather.
• ALLOWED_USER_ID: Your personal Telegram ID (can be found via userinfobot).

User ID Discovery

If you do not know your ID, run the bot with the discovery flag:

python src/main.py --userid-discovery

Then send /start to the bot, and check your terminal for the ID.

3. Run

python src/main.py

Commands

• /start - Initialize the bot.
• /mute - Enable "Stacking Mode" (silence notifications).
• /unmute - Disable silence and receive a summary of missed updates.

Testing

To run the unit tests:

pytest