folderbot 0.1.0__tar.gz

folderbot-0.1.0/.gitignore

@@ -0,0 +1,33 @@
+# Bot configuration (contains secrets)
+folderbot/config.yaml
+
+# Python
+__pycache__/
+*.py[cod]
+*.so
+.Python
+*.egg-info/
+dist/
+build/
+.eggs/
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+
+# Type checking
+.mypy_cache/
+
+# IDE
+.vscode/
+.idea/
+
+# Local database
+*.db
+
+# Virtual environments
+.venv/
+venv/
+env/

folderbot-0.1.0/PKG-INFO

@@ -0,0 +1,112 @@
+Metadata-Version: 2.4
+Name: folderbot
+Version: 0.1.0
+Summary: Telegram bot for chatting with your folder using Claude AI
+Project-URL: Homepage, https://github.com/jcardona/folderbot
+Project-URL: Repository, https://github.com/jcardona/folderbot
+Author: Jorge Cardona
+License-Expression: MIT
+Keywords: ai,bot,claude,personal-assistant,telegram
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.11
+Requires-Dist: anthropic>=0.70.0
+Requires-Dist: pathspec>=0.12.0
+Requires-Dist: python-telegram-bot>=22.0
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
+Requires-Dist: pytest-cov>=6.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Folderbot
+
+A Telegram bot that lets you chat with your folder using Claude AI.
+
+## Features
+
+- **Pre-loaded context**: Configure which files to include via glob patterns
+- **Persistent sessions**: Conversation history stored in SQLite
+- **Auto-logging**: All conversations logged to markdown files
+- **Access control**: Whitelist specific Telegram user IDs
+
+## Installation
+
+```bash
+pip install folderbot
+```
+
+Or install from source:
+
+```bash
+git clone https://github.com/jcardona/folderbot
+cd folderbot
+pip install -e .
+```
+
+## Configuration
+
+Create `folderbot/config.yaml`:
+
+```yaml
+telegram_token: "YOUR_TELEGRAM_BOT_TOKEN"
+anthropic_api_key: "YOUR_ANTHROPIC_API_KEY"
+allowed_user_ids:
+  - 123456789  # Your Telegram user ID
+
+root_folder: /path/to/your/folder
+
+read_rules:
+  include:
+    - "**/*.md"
+    - "**/*.txt"
+  exclude:
+    - "**/docs/**"
+    - ".git/**"
+
+auto_log_folder: logs/
+```
+
+Get your Telegram user ID from [@userinfobot](https://t.me/userinfobot).
+
+## Usage
+
+### Run directly
+
+```bash
+folderbot
+# or
+python -m folderbot
+```
+
+### Run as systemd service
+
+```bash
+systemctl --user enable folderbot
+systemctl --user start folderbot
+```
+
+## Commands
+
+- `/start` - Initialize bot
+- `/clear` - Clear conversation history
+- `/new` - Start new topic
+- `/status` - Show session info
+- `/files` - List files in context
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pytest
+```
+
+## License
+
+MIT

folderbot-0.1.0/README.md

@@ -0,0 +1,85 @@
+# Folderbot
+
+A Telegram bot that lets you chat with your folder using Claude AI.
+
+## Features
+
+- **Pre-loaded context**: Configure which files to include via glob patterns
+- **Persistent sessions**: Conversation history stored in SQLite
+- **Auto-logging**: All conversations logged to markdown files
+- **Access control**: Whitelist specific Telegram user IDs
+
+## Installation
+
+```bash
+pip install folderbot
+```
+
+Or install from source:
+
+```bash
+git clone https://github.com/jcardona/folderbot
+cd folderbot
+pip install -e .
+```
+
+## Configuration
+
+Create `folderbot/config.yaml`:
+
+```yaml
+telegram_token: "YOUR_TELEGRAM_BOT_TOKEN"
+anthropic_api_key: "YOUR_ANTHROPIC_API_KEY"
+allowed_user_ids:
+  - 123456789  # Your Telegram user ID
+
+root_folder: /path/to/your/folder
+
+read_rules:
+  include:
+    - "**/*.md"
+    - "**/*.txt"
+  exclude:
+    - "**/docs/**"
+    - ".git/**"
+
+auto_log_folder: logs/
+```
+
+Get your Telegram user ID from [@userinfobot](https://t.me/userinfobot).
+
+## Usage
+
+### Run directly
+
+```bash
+folderbot
+# or
+python -m folderbot
+```
+
+### Run as systemd service
+
+```bash
+systemctl --user enable folderbot
+systemctl --user start folderbot
+```
+
+## Commands
+
+- `/start` - Initialize bot
+- `/clear` - Clear conversation history
+- `/new` - Start new topic
+- `/status` - Show session info
+- `/files` - List files in context
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pytest
+```
+
+## License
+
+MIT

folderbot-0.1.0/folderbot/__init__.py

@@ -0,0 +1,3 @@
+"""Self-bot: Telegram bot for talking to your folder."""
+
+__version__ = "0.1.0"

folderbot-0.1.0/folderbot/__main__.py

@@ -0,0 +1,9 @@
+"""Entry point for folderbot: python -m folderbot"""
+
+import sys
+
+from .cli import main
+
+
+if __name__ == "__main__":
+    sys.exit(main())

folderbot-0.1.0/folderbot/claude_client.py

@@ -0,0 +1,68 @@
+"""Claude API client wrapper."""
+
+from anthropic import Anthropic
+
+from .config import Config
+from .session_manager import Message
+
+
+SYSTEM_PROMPT = """You are Jorge's personal assistant with access to his "second brain" folder.
+This folder contains his notes, logs, goals, and documentation about his life.
+
+Your role:
+- Answer questions based on the folder contents
+- Help Jorge remember things he's documented
+- Provide insights from his data (finances, health, relationships)
+- Be direct and concise - Jorge is an engineer
+- Don't be pushy or patronizing
+
+The folder contents are provided below. Use this information to answer Jorge's questions.
+
+---
+FOLDER CONTENTS:
+{context}
+---
+"""
+
+
+class ClaudeClient:
+    """Wrapper for Claude API interactions."""
+
+    def __init__(self, config: Config):
+        self.config = config
+        self.client = Anthropic(api_key=config.anthropic_api_key)
+
+    def chat(self, user_message: str, context: str, history: list[Message]) -> str:
+        """Send a message to Claude and get a response."""
+        # Build system prompt with context
+        system = SYSTEM_PROMPT.format(context=context)
+
+        # Build messages list from history
+        messages = []
+        for msg in history:
+            messages.append(
+                {
+                    "role": msg["role"],
+                    "content": msg["content"],
+                }
+            )
+
+        # Add the new user message
+        messages.append(
+            {
+                "role": "user",
+                "content": user_message,
+            }
+        )
+
+        # Call Claude API
+        response = self.client.messages.create(
+            model=self.config.model,
+            max_tokens=4096,
+            system=system,
+            messages=messages,  # type: ignore[arg-type]
+        )
+
+        # Extract text response
+        block = response.content[0]
+        return block.text if hasattr(block, "text") else str(block)