TeLLMgramBot 2.4.3__tar.gz → 2.4.4__tar.gz

{tellmgrambot-2.4.3 → tellmgrambot-2.4.4}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: TeLLMgramBot
-Version: 2.4.3
+Version: 2.4.4
 Summary: LLM-powered Telegram bot (OpenAI + Anthropic)
 Home-page: https://github.com/Digital-Heresy/TeLLMgramBot
 Author: Digital Heresy
 Author-email: ronin.atx@gmail.com
 License: MIT
-Requires-Python: >=3.12
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: openai>2.0
@@ -14,7 +14,6 @@ Requires-Dist: anthropic>=0.40
 Requires-Dist: PyYAML
 Requires-Dist: httpx
 Requires-Dist: beautifulsoup4
-Requires-Dist: typing
 Requires-Dist: validators
 Requires-Dist: tiktoken>=0.12
 Requires-Dist: python-telegram-bot>20.0
@@ -75,7 +74,8 @@ When initializing TeLLMgramBot, the following directories get created:
     * On first run, GPT and Claude model families are pre-populated. Additional models can be added manually.
 * `prompts` - Contains prompt files for how the bot interacts with any user.
     * `test_personality.prmpt` (can be a different name)
-      * A sample prompt file as a basis to test this library.
+      * A sample prompt file defining the bot's personality: generic, helpful, and multi-provider-aware.
+      * The prompt emphasizes the bot's ability to fetch and analyze URLs passed in square brackets `[]`.
       * The user can create more prompt files as needed for different personalities.
     * `url_analysis.prmpt`
       * Prompt template used to analyze URL content passed in brackets `[]`.
@@ -126,7 +126,7 @@ This means the user can implement whatever key vault they want to fetch the keys
 ### API Key Files
 The other route is to create files by the base path during execution or a specified environment variable `TELLMGRAMBOT_KEYS_PATH`. By default, files are created for the user to input each API key:
 1. `openai.key`
-2. `anthropic.key` _(planned — env var only for now; see Phase 3)_
+2. `anthropic.key`
 3. `telegram.key`
 4. `virustotal.key`
 

{tellmgrambot-2.4.3 → tellmgrambot-2.4.4}/README.md

@@ -44,7 +44,8 @@ When initializing TeLLMgramBot, the following directories get created:
     * On first run, GPT and Claude model families are pre-populated. Additional models can be added manually.
 * `prompts` - Contains prompt files for how the bot interacts with any user.
     * `test_personality.prmpt` (can be a different name)
-      * A sample prompt file as a basis to test this library.
+      * A sample prompt file defining the bot's personality: generic, helpful, and multi-provider-aware.
+      * The prompt emphasizes the bot's ability to fetch and analyze URLs passed in square brackets `[]`.
       * The user can create more prompt files as needed for different personalities.
     * `url_analysis.prmpt`
       * Prompt template used to analyze URL content passed in brackets `[]`.
@@ -95,7 +96,7 @@ This means the user can implement whatever key vault they want to fetch the keys
 ### API Key Files
 The other route is to create files by the base path during execution or a specified environment variable `TELLMGRAMBOT_KEYS_PATH`. By default, files are created for the user to input each API key:
 1. `openai.key`
-2. `anthropic.key` _(planned — env var only for now; see Phase 3)_
+2. `anthropic.key`
 3. `telegram.key`
 4. `virustotal.key`
 

{tellmgrambot-2.4.3 → tellmgrambot-2.4.4}/TeLLMgramBot/initialize.py

@@ -16,7 +16,12 @@ INIT_BOT_CONFIG = {
     'url_model': 'gpt-5',
     'token_limit': None,
     'persona_temp': None,
-    'persona_prompt': 'You are a test harness bot.'
+    'persona_prompt': 'You are a generic test bot powered by a user-configured LLM.'
+}
+
+INIT_BOT_CONFIG_COMMENTS = {
+    'token_limit': '# Optional, overrides the chat_model\'s default max token limit',
+    'persona_temp': '# Optional, LLM temperature 0.0-2.0 (default: model\'s default)',
 }
 
 def execution_dir() -> str:
@@ -138,7 +143,21 @@ def init_keys():
 def init_bot_config(file='config.yaml') -> str:
     """
     Ensure bot configuration file (default 'config.yaml') is created.
-    Must specify the environment variable 'TELLMGRAMBOT_CONFIGS_PATH'.
+
+    Creates a basic bot configuration file in TELLMGRAMBOT_CONFIGS_PATH with default values
+    and inline parameter comments. Optional parameters (those with None values in INIT_BOT_CONFIG)
+    are populated with descriptions from INIT_BOT_CONFIG_COMMENTS instead of values, helping
+    users understand when to set them.
+
+    Args:
+        file: Name of the configuration file to create (default: 'config.yaml').
+
+    Returns:
+        Path to the created or existing configuration file.
+
+    Raises:
+        SystemExit: If TELLMGRAMBOT_CONFIGS_PATH environment variable is not defined,
+                   or if file creation fails.
     """
     env_var = "TELLMGRAMBOT_CONFIGS_PATH"
     try:
@@ -151,10 +170,10 @@ def init_bot_config(file='config.yaml') -> str:
                 for parameter, value in INIT_BOT_CONFIG.items():
                     if parameter == 'persona_prompt':
                         continue
-                    else:  # Write parameter, with optional comment if no value
+                    else:  # Write parameter, with inline comment if no value
                         f.write('%s : %s\n' % (
                             parameter.ljust(12),
-                            value if value else '# Optional, see README'
+                            value if value else INIT_BOT_CONFIG_COMMENTS.get(parameter, '# Optional')
                         ))
         return path
     except KeyError:
@@ -211,9 +230,9 @@ def init_bot_prompt(file='test_personality.prmpt') -> str:
     env_var = "TELLMGRAMBOT_PROMPTS_PATH"
     try:
         return generate_file_path(os.environ[env_var], file, "bot personality prompt",
-            "You are a test harness bot that can:\n"
-            "1. Fetch and analyze URLs provided in [square brackets].\n"
-            "2. Safety-check URLs via VirusTotal.\n"
+            "You are a generic test bot powered by a user-configured LLM. "
+            "You respond helpfully to messages and, when a URL is provided in [square brackets], "
+            "you fetch and analyze its contents after verifying it is safe via VirusTotal.\n"
         )
     except KeyError:
         sys.exit(f"{env_var} must be defined to create file '{file}'! Exiting...")
@@ -246,10 +265,14 @@ def init_url_prompt(file='url_analysis.prmpt') -> str:
 
 def init_structure():
     """
-    Performs the whole TeLLMgramBot setup including:
+    Performs the whole TeLLMgramBot first-run setup including:
     - Directories for configurations, prompts, and conversation/error logs.
-    - OpenAI, Telegram, and VirusTotal keys.
-    - URL and bot configuration files including model tokens.
+    - Provider-conditional API keys (OpenAI/Anthropic determined by config.yaml model prefixes).
+    - Configuration files (config.yaml, tokenGPT.yaml) with inline parameter descriptions.
+    - System prompt files (test_personality.prmpt, url_analysis.prmpt).
+
+    Provider key requirements are inferred from config.yaml model prefixes (claude-* → Anthropic,
+    gpt-* → OpenAI, etc.) to streamline setup for single-provider deployments.
     """
     init_directories()
     init_keys()

{tellmgrambot-2.4.3 → tellmgrambot-2.4.4}/TeLLMgramBot.egg-info/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: TeLLMgramBot
-Version: 2.4.3
+Version: 2.4.4
 Summary: LLM-powered Telegram bot (OpenAI + Anthropic)
 Home-page: https://github.com/Digital-Heresy/TeLLMgramBot
 Author: Digital Heresy
 Author-email: ronin.atx@gmail.com
 License: MIT
-Requires-Python: >=3.12
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: openai>2.0
@@ -14,7 +14,6 @@ Requires-Dist: anthropic>=0.40
 Requires-Dist: PyYAML
 Requires-Dist: httpx
 Requires-Dist: beautifulsoup4
-Requires-Dist: typing
 Requires-Dist: validators
 Requires-Dist: tiktoken>=0.12
 Requires-Dist: python-telegram-bot>20.0
@@ -75,7 +74,8 @@ When initializing TeLLMgramBot, the following directories get created:
     * On first run, GPT and Claude model families are pre-populated. Additional models can be added manually.
 * `prompts` - Contains prompt files for how the bot interacts with any user.
     * `test_personality.prmpt` (can be a different name)
-      * A sample prompt file as a basis to test this library.
+      * A sample prompt file defining the bot's personality: generic, helpful, and multi-provider-aware.
+      * The prompt emphasizes the bot's ability to fetch and analyze URLs passed in square brackets `[]`.
       * The user can create more prompt files as needed for different personalities.
     * `url_analysis.prmpt`
       * Prompt template used to analyze URL content passed in brackets `[]`.
@@ -126,7 +126,7 @@ This means the user can implement whatever key vault they want to fetch the keys
 ### API Key Files
 The other route is to create files by the base path during execution or a specified environment variable `TELLMGRAMBOT_KEYS_PATH`. By default, files are created for the user to input each API key:
 1. `openai.key`
-2. `anthropic.key` _(planned — env var only for now; see Phase 3)_
+2. `anthropic.key`
 3. `telegram.key`
 4. `virustotal.key`
 

{tellmgrambot-2.4.3 → tellmgrambot-2.4.4}/TeLLMgramBot.egg-info/requires.txt

@@ -3,7 +3,6 @@ anthropic>=0.40
 PyYAML
 httpx
 beautifulsoup4
-typing
 validators
 tiktoken>=0.12
 python-telegram-bot>20.0

{tellmgrambot-2.4.3 → tellmgrambot-2.4.4}/setup.py

@@ -5,7 +5,7 @@ with open("README.md", "r") as fh:
 
 setup(
     name='TeLLMgramBot',
-    version='2.4.3',
+    version='2.4.4',
     packages=find_packages(),
     license='MIT',
     author='Digital Heresy',
@@ -20,10 +20,9 @@ setup(
         'PyYAML',
         'httpx',
         'beautifulsoup4',
-        'typing',
         'validators',
         'tiktoken>=0.12',
         'python-telegram-bot>20.0'
     ],
-    python_requires='>=3.12'
+    python_requires='>=3.10'
 )