Metadata-Version: 2.4
Name: folderbot
Version: 0.1.11
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
