botbook/src/features.md

# Feature System

**Version:** 6.2.0

General Bots uses Cargo's feature flags to create modular, size-optimized builds. This allows you to include only the functionality you need.

---

## Feature Dependency Tree

<img src="assets/feature-dependency-tree.svg" alt="Feature Dependency Tree" width="100%">

---

## Quick Start

### Building with Specific Features

```bash
# Minimal build (chat only)
cargo build --features "chat" --no-default-features

# Chat + Cloud Storage
cargo build --features "chat,drive" --no-default-features

# Spreadsheet + Cloud Storage
cargo build --features "sheet,drive" --no-default-features

# Chat with Local LLM
cargo build --features "chat,llm" --no-default-features

# Full productivity suite
cargo build --features "full"
```

---

## Feature Categories

### 🗣️ Communication Apps

| Feature | Dependencies | Description |
|---------|--------------|-------------|
| `chat` | None | Basic chat functionality |
| `people` | None | Contact management |
| `mail` | lettre, mailparse, imap, native-tls | Email integration |
| `meet` | livekit | Video conferencing |
| `whatsapp` | None | WhatsApp integration |
| `telegram` | None | Telegram integration |
| `instagram` | None | Instagram integration |
| `msteams` | None | Microsoft Teams integration |
| `social` | None | Social media features |

### 📋 Productivity Apps

| Feature | Dependencies | Description |
|---------|--------------|-------------|
| `calendar` | None | Calendar functionality |
| `tasks` | cron, automation | Task management with scheduling |
| `project` | quick-xml | Project management (MS Project) |
| `goals` | None | Goals tracking |
| `workspace` | None | Single workspace |
| `tickets` | None | Ticket system |
| `billing` | None | Billing system |

### 📄 Document Apps

| Feature | Dependencies | Description |
|---------|--------------|-------------|
| `docs` | docx-rs, ooxmlsdk | Word document processing |
| `sheet` | calamine, spreadsheet-ods | Spreadsheet processing |
| `slides` | ooxmlsdk | Presentation processing |
| `paper` | docs, pdf-extract | PDF processing |
| `drive` | aws-config, aws-sdk-s3, aws-smithy-async, pdf-extract | Cloud storage (S3) |

### 🎥 Media Apps

| Feature | Dependencies | Description |
|---------|--------------|-------------|
| `video` | None | Video features |
| `player` | None | Media player |
| `canvas` | None | Drawing/canvas |

### 🧠 Learning & Research

| Feature | Dependencies | Description |
|---------|--------------|-------------|
| `learn` | None | Learning features |
| `research` | llm, vectordb | Research with AI |
| `sources` | None | Data sources |

### 📊 Analytics

| Feature | Dependencies | Description |
|---------|--------------|-------------|
| `analytics` | None | Analytics features |
| `dashboards` | None | Dashboard UI |
| `monitoring` | sysinfo | System monitoring |

### 🔧 Development Tools

| Feature | Dependencies | Description |
|---------|--------------|-------------|
| `designer` | None | UI designer |
| `editor` | None | Code/text editor |
| `automation` | rhai, cron | Scripting automation |

### ⚙️ Core Technologies

| Feature | Dependencies | Description |
|---------|--------------|-------------|
| `llm` | None | LLM integration flag |
| `vectordb` | qdrant-client | Vector database |
| `cache` | redis | Redis caching |
| `compliance` | csv | Compliance reporting |
| `console` | crossterm, ratatui, monitoring | Terminal UI |
| `jemalloc` | tikv-jemallocator, tikv-jemalloc-ctl | Memory allocator |
| `progress-bars` | indicatif | Progress indicators |

---

## Pre-Defined Bundles

### `minimal`
```toml
minimal = ["chat"]
```
Smallest possible build. Just chat functionality.

### `lightweight`
```toml
lightweight = ["chat", "drive", "tasks", "people"]
```
Small but useful for basic operations.

### `default`
```toml
default = ["chat", "drive", "tasks", "automation", "cache", "directory"]
```
Balanced default configuration.

### `full`
```toml
full = [
    "chat", "people", "mail",
    "tasks", "calendar",
    "drive", "docs",
    "llm", "cache", "compliance"
]
```
Everything useful for a complete deployment.

---

## Common Scenarios

### 📱 Chat + Drive (Minimum Cloud)

```bash
cargo build --features "chat,drive" --no-default-features
```

**Use case:** Basic chat with file storage capabilities.

### 📊 Sheets + Drive

```bash
cargo build --features "sheet,drive" --no-default-features
```

**Use case:** Spreadsheet processing with cloud storage.

> ⚠️ **Note:** `sheet` does NOT require `drive` for local file processing. Add `drive` only if you need cloud storage.

### 🤖 Chat + Local LLM

```bash
cargo build --features "chat,llm" --no-default-features
```

**Use case:** Chat with local LLM integration (limited resources).

### 🏢 Office Suite

```bash
cargo build --features "docs,sheet,slides,drive" --no-default-features
```

**Use case:** Full document processing suite.

### 📧 Email-Focused

```bash
cargo build --features "chat,mail,cache" --no-default-features
```

**Use case:** Chat with email integration.

---

## Feature Validation

Some features have implicit dependencies:

| If you enable... | You automatically get... |
|------------------|--------------------------|
| `tasks` | `automation` |
| `paper` | `docs` |
| `research` | `llm`, `vectordb` |
| `console` | `monitoring` |
| `communications` | All communication features + `cache` |
| `productivity` | All productivity features + `cache` |
| `documents` | All document features |

---

## Size Comparison

| Build Configuration | Approximate Size |
|--------------------|------------------|
| `minimal` | ~15 MB |
| `lightweight` | ~25 MB |
| `default` | ~35 MB |
| `full` | ~60 MB |

*Sizes are approximate and vary based on platform and optimization level.*