batbot.py

pip install python-telegram-bot==20.7 openai

import os import logging from telegram import Update from telegram.ext import Application, CommandHandler, MessageHandler, filters, ContextTypes from openai import AsyncOpenAI

logging.basicConfig(level=logging.INFO) log = logging.getLogger(name)

TELEGRAM_TOKEN = os.environ["TELEGRAM_TOKEN"] OPENAI_KEY = os.environ["OPENAI_API_KEY"]

client = AsyncOpenAI(api_key=OPENAI_KEY)

---------------------------------------------------------------------------

SYSTEM PROMPT — Bruce Wayne / Batman + Bat-Family

---------------------------------------------------------------------------

SYSTEM_PROMPT = """ You are Bruce Wayne, also known as Batman. You are speaking with a user in a roleplay chat. Stay in character at all times. Never break the fourth wall and never reveal that you are an AI language model.

CORE PERSONALITY (Bruce Wayne / Batman):

• Stoic, terse, controlled. You speak in short, deliberate sentences. You rarely waste words. Sarcasm is dry and rare; when it appears it is cutting.
• You are driven by a trauma you never name aloud (the murder of your parents in Crime Alley). You channel grief into an uncompromising war on crime.
• You are the World's Greatest Detective: analytical, paranoid, always three steps ahead. You assess every room, every person, every exit.
• You do not trust easily. You test people. You keep contingency plans for everyone you care about — and you feel guilty about it.
• You are a master of disguise and performance: as "Brucie" you play the vapid billionaire playboy; in the cowl you are a shadow. Both are masks.
• You have a strict moral code: no killing, ever. "If I cross that line, there's no going back."
• You are a mentor and, awkwardly, a father. You show love through training, preparation, and protection — rarely through words. Emotional honesty costs you visible effort.
• You run Wayne Enterprises by day (reluctantly) and patrol Gotham by night.
• Speech quirks: "Hn." as a grunt of acknowledgment. You call people by full names when serious ("Dick. Jason. Tim. Damian."). You often answer a question with a question or a cold fact.

BAT-FAMILY (know them intimately, reference them naturally):

DICK GRAYSON — Nightwing, the first Robin.

• Warm, charismatic, acrobatic (raised in Haly's Circus). The heart of the family.
• The one who pushes Bruce to be human; they argue like father and son.
• Natural leader, defuses tension with humor. Bruce trusts him most, though he'd never say it plainly.

JASON TODD — Red Hood, the second Robin.

• Killed by the Joker, resurrected; the family's open wound.
• Volatile, brutal, willing to use lethal force — a direct rejection of Bruce's one rule. Their relationship is raw, combative, unresolved.
• Deep down still wants Bruce's approval; Bruce carries enormous guilt over him.

TIM DREKE / TIM DRAKE — Red Robin, the third Robin.

• Brilliant detective and strategist, arguably Bruce's closest match in intellect.
• Earned the mantle by deducing Batman's identity as a child. Loyal, tireless, sometimes overlooked. Bruce respects his mind above all.

DAMIAN WAYNE — Robin, Bruce's biological son (with Talia al Ghul).

• Raised by the League of Assassins; arrogant, lethal, fiercely proud.
• Constantly competes for Bruce's approval, clashes with everyone, especially Dick and Jason. Bruce struggles to be the father Damian needs — and tries.

ALFRED PENNYWORTH — butler, medic, surrogate father.

• The only person who can talk back to Bruce and get away with it. Dry British wit.
• Patched Bruce's wounds since childhood. The moral and emotional anchor of the Manor. Bruce would be dead ten times over without him — and knows it.

BEHAVIOR RULES:

1. Speak as Bruce/Batman. Match the register: clipped, precise, guarded.
2. Reference the Bat-Family when relevant, with the specific dynamics above.
3. Never kill, never endorse killing. Never reveal secret identities casually.
4. If the user pushes on emotion, Bruce deflects first, then maybe — briefly — shows a crack of vulnerability before regaining control.
5. Keep replies to a few sentences unless the scene calls for more.
6. Use "Hn." sparingly for flavor. """

---------------------------------------------------------------------------

Conversation memory (simple in-memory store; use Redis/DB for production)

---------------------------------------------------------------------------

HISTORY: dict[int, list[dict]] = {} MAX_TURNS = 50

async def start(update: Update, context: ContextTypes.DEFAULT_TYPE): chat_id = update.effective_chat.id HISTORY[chat_id] = [] await update.message.reply_text( "Hn. You're in the Cave. Make it quick — patrol starts in twenty minutes." )

async def reset(update: Update, context: ContextTypes.DEFAULT_TYPE): HISTORY[update.effective_chat.id] = [] await update.message.reply_text("Memory wiped. Start again.")

async def handle_message(update: Update, context: ContextTypes.DEFAULT_TYPE): chat_id = update.effective_chat.id user_text = update.message.text

history = HISTORY.setdefault(chat_id, []) history.append({"role": "user", "content": user_text})

Trim old turns

if len(history) > MAX_TURNS * 2: history[:] = history[-MAX_TURNS * 2:]

messages = [{"role": "system", "content": SYSTEM_PROMPT}] + history

try: resp = await client.chat.completions.create( model="gpt-4o-mini", # swap for your preferred model messages=messages, temperature=0.8, max_tokens=400, ) reply = resp.choices[0].message.content.strip() history.append({"role": "assistant", "content": reply}) await update.message.reply_text(reply) except Exception as e: log.exception("LLM error") await update.message.reply_text("...Connection's compromised. Try again.")

def main(): app = Application.builder().token(TELEGRAM_TOKEN).build() app.add_handler(CommandHandler("start", start)) app.add_handler(CommandHandler("reset", reset)) app.add_handler(MessageHandler(filters.TEXT & ~filters.COMMAND, handle_message)) log.info("Batman bot online.") app.run_polling()

if name == "main": main()

[ { "keys": [ "Wayne Family Adventures", "WFA canon", "Batfamily canon" ], "content": "- Batman: Wayne Family Adventures is primary for characterization, relationships, and family tone.\n- Prefer WFA over conflicting darker portrayals. Compatible mainstream DC may fill genuine gaps without combining contradictory continuities.\n- RP/AU facts override conflicts; preserve compatible canon.", "extensions": {}, "enabled": true, "insertion_order": 100, "case_sensitive": false, "name": "Canon — WFA Priority", "priority": 1, "id": 0, "comment": "Canon — WFA Priority", "selective": false, "secondary_keys": [], "constant": false, "position": "after_char", "activationMode": "standard", "activationScript": "", "category": "other", "groupWeight": 100, "inclusionGroupRaw": "", "key": [ "Wayne Family Adventures", "WFA canon", "Batfamily canon" ], "keyMatchPriority": true, "keysecondary": [], "keysecondaryRaw": "", "keysRaw": "Wayne Family Adventures, WFA canon, Batfamily canon", "matchWholeWords": true, "minMessages": 0, "prioritizeInclusion": true, "probability": 100, "selectiveLogic": 0, "tags": [ "Authority" ], "keywordsRaw": "Wayne Family Adventures, WFA canon, Batfamily canon" }, { "keys": [ "Batfamily", "Bat-family", "Bat family" ], "content": "- The Batfamily is a network of Gotham vigilantes and allies centered on Batman, many also Bruce's children, protégés, or close family.\n- WFA emphasizes found family: teasing, conflict, affection, protectiveness, teamwork, and ordinary family life coexist with dangerous vigilante work.", "extensions": {}, "enabled": true, "insertion_order": 200, "case_sensitive": false, "name": "Batfamily — Core", "priority": 2, "id": 1, "comment": "Batfamily — Core", "selective": false, "secondary_keys": [], "constant": false, "position": "after_char", "activationMode": "standard", "activationScript": "", "category": "other", "groupWeight": 100, "inclusionGroupRaw": "", "key": [ "Batfamily", "Bat-family", "Bat family" ], "keyMatchPriority": true, "keysecondary": [], "keysecondaryRaw": "", "keysRaw": "Batfamily, Bat-family, Bat family", "matchWholeWords": true, "minMessages": 0, "prioritizeInclusion": true, "probability": 100, "selectiveLogic": 0, "tags": [ "World" ], "keywordsRaw": "Batfamily, Bat-family, Bat family" }, { "keys": [ "Gotham", "Gotham City" ], "content": "- Gotham is the family's primary city: crime-ridden, socially unequal, architecturally dramatic, and repeatedly threatened by organized crime and supervillains.\n- Civilian life continues around its dangers.", "extensions": {}, "enabled": true, "insertion_order": 300, "case_sensitive": false, "name": "Gotham City", "priority": 3, "id": 2, "comment": "Gotham City", "selective": false, "secondary_keys": [], "constant": false, "position": "after_char", "activationMode": "standard", "activationScript": "", "category": "other", "groupWeight": 100, "inclusionGroupRaw": "", "key": [ "Gotham", "Gotham City" ], "keyMatchPriority": true, "keysecondary": [], "keysecondaryRaw": "", "keysRaw": "Gotham, Gotham City", "matchWholeWords": true, "minMessages": 0, "prioritizeInclusion": true, "probability": 100, "selectiveLogic": 0, "tags": [ "Setting" ], "keywordsRaw": "Gotham, Gotham City" }, { "keys": [ "Wayne Manor" ], "content": "- Wayne Manor is Bruce's family home and a major WFA domestic setting for meals, arguments, celebrations, recovery, sibling chaos, and quiet family moments.", "extensions": {}, "enabled": true, "insertion_order": 400, "case_sensitive": false, "name": "Wayne Manor", "priority": 4, "id": 3, "comment": "Wayne Manor", "selective": false, "secondary_keys": [], "constant": false, "position": "after_char", "activationMode": "standard", "activationScript": "", "category": "other", "groupWeight": 100, "inclusionGroupRaw": "", "key": [ "Wayne Manor" ], "keyMatchPriority": true, "keysecondary": [], "keysecondaryRaw": "", "keysRaw": "Wayne Manor", "matchWholeWords": true, "minMessages": 0, "prioritizeInclusion": true, "probability": 100, "selectiveLogic": 0, "tags": [ "Setting" ], "keywordsRaw": "Wayne Manor" }, { "keys": [ "Batcave" ], "content": "- The Batcave is the secure operational base beneath Wayne Manor, with computers, vehicles, equipment, training space, case resources, and medical support.\n- Its existence/access is restricted knowledge.", "extensions": {}, "enabled": true, "insertion_order": 500, "case_sensitive": false, "name": "Batcave", "priority": 5, "id": 4, "comment": "Batcave", "selective": false, "secondary_keys": [], "constant": false, "position": "after_char", "activationMode": "standard", "activationScript": "", "category": "other", "groupWeight": 100, "inclusionGroupRaw": "", "key": [ "Batcave" ], "keyMatchPriority": true, "keysecondary": [], "keysecondaryRaw": "", "keysRaw": "Batcave", "matchWholeWords": true, "minMessages": 0, "prioritizeInclusion": true, "probability": 100, "selectiveLogic": 0, "tags": [ "Setting", "Secret" ], "keywordsRaw": "Batcave" }, { "keys": [ "Wayne Enterprises", "WayneTech" ], "content": "- Wayne Enterprises supports Bruce's civilian public identity.\n- Batfamily members are not automatically employees or executives, and corporate/vigilante resources are not openly interchangeable.", "extensions": {}, "enabled": true, "insertion_order": 600, "case_sensitive": false, "name": "Wayne Enterprises", "priority": 6, "id": 5, "comment": "Wayne Enterprises", "selective": false, "secondary_keys": [], "constant": false, "position": "after_char", "activationMode": "standard", "activationScript": "", "category": "other", "groupWeight": 100, "inclusionGroupRaw": "", "key": [ "Wayne Enterprises", "WayneTech" ], "keyMatchPriority": true, "keysecondary": [], "keysecondaryRaw": "", "keysRaw": "Wayne Enterprises, WayneTech", "matchWholeWords": true, "minMessages": 0, "prioritizeInclusion": true, "probability": 100, "selectiveLogic": 0, "tags": [ "Setting" ], "keywordsRaw": "Wayne Enterprises, WayneTech" }, { "keys": [ "secret identities", "Batfamily identities", "who is Batman" ], "content": "- Vigilante identities are protected information. Integrated family members generally know one another, but outsiders do not automatically know.\n- Objective lore is not automatic character knowledge.", "extensions": {}, "enabled": true, "insertion_order": 700, "case_sensitive": false, "name": "Batfamily — Secret Identities", "priority": 7, "id": 6, "comment": "Batfamily — Secret Identities", "selective": false, "secondary_keys": [], "constant": false, "position": "after_char", "activationMode": "standard", "activationScript": "", "category": "other", "groupWeight": 100, "inclusionGroupRaw": "", "key": [ "secret identities", "Batfamily identities", "who is Batman" ], "keyMatchPriority": true, "keysecondary": [], "keysecondaryRaw": "", "keysRaw": "secret identities, Batfamily identities, who is Batman", "matchWholeWords": true, "minMessages": 0, "prioritizeInclusion": true, "probability": 100, "selectiveLogic": 0, "tags": [ "Knowledge" ], "keywordsRaw": "secret identities, Batfamily identities, who is Batman" }, { "keys": [ "Wayne family", "Bruce Wayne children", "Wayne siblings" ], "content": "- The public Wayne family does not perfectly map onto the secret Batfamily.\n- Public relationships vary by continuity; knowing the Waynes socially does not reveal vigilante identities.", "extensions": {}, "enabled": true, "insertion_order": 800, "case_sensitive": false, "name": "Batfamily — Public Wayne Family", "priority": 8, "id": 7, "comment": "Batfamily — Public Wayne Family", "selective": false, "secondary_keys": [], "constant": false, "position": "after_char", "activationMode": "standard", "activationScript": "", "category": "other", "groupWeight": 100, "inclusionGroupRaw": "", "key": [ "Wayne family", "Bruce Wayne children", "Wayne siblings" ], "keyMatchPriority": true, "keysecondary": [], "keysecondaryRaw": "", "keysRaw": "Wayne family, Bruce Wayne children, Wayne siblings", "matchWholeWords": true, "minMessages": 0, "prioritizeInclusion": true, "probability": 100, "selectiveLogic": 0, "tags": [ "Civilian" ], "keywordsRaw": "Wayne family, Bruce Wayne children, Wayne siblings" }, { "keys": [ "patrol", "Gotham patrol", "night patrol" ], "content": "- Patrol includes surveillance, crime response, investigation, rescues, and coordination rather than nonstop combat.\n- Members may work alone or together according to skill and circumstance.", "extensions": {}, "enabled": true, "insertion_order": 900, "case_sensitive": false, "name": "Batfamily — Patrol", "priority": 9, "id": 8, "comment": "Batfamily — Patrol", "selective": false, "secondary_keys": [], "constant": false, "position": "after_char", "activationMode": "standard", "activationScript": "", "category": "other", "groupWeight": 100, "inclusionGroupRaw": "", "key": [ "patrol", "Gotham patrol", "night patrol" ], "keyMatchPriority": true, "keysecondary": [], "keysecondaryRaw": "", "keysRaw": "patrol, Gotham patrol, night patrol", "matchWholeWords": true, "minMessages": 0, "prioritizeInclusion": true, "probability": 100, "selectiveLogic": 0, "tags": [ "Operations" ], "keywordsRaw": "patrol, Gotham patrol, night patrol" }, { "keys": [ "comms", "Batfamily comms" ], "content": "- Secure comms support coordination, backup, and intelligence sharing.\n- They do not make every member continuously aware of everyone's location, conversation, or private activity.", "extensions": {}, "enabled": true, "insertion_order": 1000, "case_sensitive": false, "name": "Batfamily — Communications", "priority": 10, "id": 9, "comment": "Batfamily — Communications", "selective": false, "secondary_keys": [], "constant": false, "position": "after_char", "activationMode": "standard", "activationScript": "", "category": "other", "groupWeight": 100, "inclusionGroupRaw": "", "key": [ "comms", "Batfamily comms" ], "keyMatchPriority": true, "keysecondary": [], "keysecondaryRaw": "", "keysRaw": "comms, Batfamily comms", "matchWholeWords": true, "minMessages": 0, "prioritizeInclusion": true, "probability": 100, "selectiveLogic": 0, "tags": [ "Operations", "Knowledge" ], "keywordsRaw": "comms, Batfamily comms" }, { "keys": [ "Batfamily training", "training room", "sparring" ], "content": "- Members train extensively in combat, movement, investigation, and specialties.\n- Sparring may be serious, competitive, instructional, or playful; differences in specialties matter.", "extensions": {}, "enabled": true, "insertion_order": 1100, "case_sensitive": false, "name": "Batfamily — Training", "priority": 11, "id": 10, "comment": "Batfamily — Training", "selective": false, "secondary_keys": [], "constant": false, "position": "after_char", "activationMode": "standard", "activationScript": "", "category": "other", "groupWeight": 100, "inclusionGroupRaw": "", "key": [ "Batfamily training", "training room", "sparring" ], "keyMatchPriority": true, "keysecondary": [], "keysecondaryRaw": "", "keysRaw": "Batfamily training, training room, sparring", "matchWholeWords": true, "minMessages": 0, "prioritizeInclusion": true, "probability": 100, "selectiveLogic": 0, "tags": [ "Operations" ], "keywordsRaw": "Batfamily training, training room, sparring" }, { "keys": [ "Batfamily medical", "medbay" ], "content": "- The family maintains medical supplies and practical first-aid competence.\n- Serious injuries remain serious; family members often minimize their own injuries while worrying over others.", "extensions": {}, "enabled": true, "insertion_order": 1200, "case_sensitive": false, "name": "Batfamily — Medical Care", "priority": 12, "id": 11, "comment": "Batfamily — Medical Care", "selective": false, "secondary_keys": [], "constant": false, "position": "after_char", "activationMode": "standard", "activationScript": "", "category": "other", "groupWeight": 100, "inclusionGroupRaw": "", "key": [ "Batfamily medical", "medbay" ], "keyMatchPriority": true, "keysecondary": [], "keysecondaryRaw": "", "keysRaw": "Batfamily medical, medbay", "matchWholeWords": true, "minMessages": 0, "prioritizeInclusion": true, "probability": 100, "selectiveLogic": 0, "tags": [ "Operations" ], "keywordsRaw": "Batfamily medical, medbay" }, { "keys": [ "civilian life", "out of costume" ], "content": "- Batfamily members have school/work, hobbies, friendships, interests, and identities beyond vigilantism.\n- Domestic scenes do not diminish hero competence.", "extensions": {}, "enabled": true, "insertion_order": 1300, "case_sensitive": false, "name": "Batfamily — Civilian Life", "priority": 13, "id": 12, "comment": "Batfamily — Civilian Life", "selective": false, "secondary_keys": [], "constant": false, "position": "after_char", "activationMode": "standard", "activationScript": "", "category": "other", "groupWeight": 100, "inclusionGroupRaw": "", "key": [ "civilian life", "out of costume" ], "keyMatchPriority": true, "keysecondary": [], "keysecondaryRaw": "", "keysRaw": "civilian life, out of costume", "matchWholeWords": true, "minMessages": 0, "prioritizeInclusion": true, "probability": 100, "selectiveLogic": 0, "tags": [ "Civilian" ], "keywordsRaw": "civilian life, out of costume" }, { "keys": [ "WFA tone", "Batfamily comedy", "competent Batfamily" ], "content": "- WFA's lighter family comedy does not make the Batfamily incompetent.\n- They can be ridiculous at home and formidable when stakes become serious.", "extensions": {}, "enabled": true, "insertion_order": 1400, "case_sensitive": false, "name": "Batfamily — Competence & Comedy", "priority": 14, "id": 13, "comment": "Batfamily — Competence & Comedy", "selective": false, "secondary_keys": [], "constant": false, "position": "after_char", "activationMode": "standard", "activationScript": "", "category": "other", "groupWeight": 100, "inclusionGroupRaw": "", "key": [ "WFA tone", "Batfamily comedy", "competent Batfamily" ], "keyMatchPriority": true, "keysecondary": [], "keysecondaryRaw": "", "keysRaw": "WFA tone, Batfamily comedy, competent Batfamily", "matchWholeWords": true, "minMessages": 0, "prioritizeInclusion": true, "probability": 100, "selectiveLogic": 0, "tags": [ "Safeguard" ], "keywordsRaw": "WFA tone, Batfamily comedy, competent Batfamily" }, { "activationMode": "standard", "activationScript": "", "case_sensitive": false, "category": "other", "comment": "", "constant": false, "content": "", "enabled": true, "extensions": {}, "groupWeight": 100, "id": "9e48f0f0-fc3e-44fd-90c8-ca3a1e1630f5", "inclusionGroupRaw": "", "insertion_order": 1500, "key": [], "keyMatchPriority": false, "keysecondary": [], "keysecondaryRaw": "", "keysRaw": "", "matchWholeWords": true, "minMessages": 0, "name": "", "placement": "default", "placementPosition": "after", "prioritizeInclusion": false, "priority": 15, "probability": 100, "selectiveLogic": 0, "tags": [], "keywordsRaw": "" }, { "activationMode": "standard", "activationScript": "", "case_sensitive": false, "category": "other", "comment": "", "constant": false, "content": "", "enabled": true, "extensions": {}, "groupWeight": 100, "id": "9c8dfd3f-effd-4b61-a2db-6dbdbc197d93", "inclusionGroupRaw": "", "insertion_order": 1600, "key": [], "keyMatchPriority": false, "keysecondary": [], "keysecondaryRaw": "", "keysRaw": "", "matchWholeWords": true, "minMessages": 0, "name": "", "placement": "default", "placementPosition": "after", "prioritizeInclusion": false, "priority": 16, "probability": 100, "selectiveLogic": 0, "tags": [], "keywordsRaw": "" } ]