General Bots Templates

Pre-built templates for bots, apps, prompts, and UI components. Everything you need to get started quickly.

---

Repository Structure

bottemplates/
├── bots/                    # Complete bot packages (.gbai)
│   ├── core/                # Essential starter bots
│   ├── sales/               # CRM, marketing, lead management
│   ├── compliance/          # LGPD, GDPR, HIPAA
│   ├── finance/             # Banking, payments, invoicing
│   ├── healthcare/          # Patient communication, appointments
│   ├── hr/                  # Employee management, onboarding
│   ├── it/                  # Helpdesk, IT service management
│   ├── nonprofit/           # Donor management, volunteers
│   ├── education/           # Courses, training, LMS
│   └── integration/         # External API integrations
├── apps/                    # HTMX web application templates
│   ├── dashboard/           # Analytics and KPI dashboards
│   ├── crud/                # Generic CRUD interfaces
│   ├── kanban/              # Board-style project management
│   ├── admin/               # Admin panel templates
│   └── components/          # Reusable UI components
├── prompts/                 # System prompts and LLM configurations
│   ├── assistants/          # Role-specific assistant prompts
│   ├── tools/               # Tool description templates
│   └── personas/            # Bot personality definitions
├── dialogs/                 # Reusable BASIC dialog scripts
│   ├── auth/                # Authentication flows
│   ├── notifications/       # Email, SMS, WhatsApp patterns
│   ├── data/                # CRUD operation patterns
│   └── integrations/        # API integration patterns
└── themes/                  # UI themes (.gbtheme)
    ├── default/             # Standard theme
    ├── dark/                # Dark mode theme
    └── corporate/           # Business-focused themes

---

Quick Start

Install a Bot Template

# From CLI
botserver --install-template crm

# Or copy manually
cp -r bottemplates/bots/sales/crm.gbai /path/to/your/packages/

Use an App Template

' Generate a CRM app from template
CREATE SITE "my-crm", "bottemplates/apps/crud", "Build a customer management system"

Apply a Prompt Template

' Load a sales assistant prompt
SET SYSTEM PROMPT FROM FILE "bottemplates/prompts/assistants/sales.md"

---

Bots

Complete .gbai packages ready to deploy.

Core

Template	Description
default.gbai	Minimal starter bot
template.gbai	Reference implementation for creating new bots

Sales & Marketing

Template	Description
crm.gbai	Full CRM with leads, contacts, opportunities
marketing.gbai	Campaign management, email sequences
attendance-crm.gbai	Event attendance tracking

Compliance

Template	Description
privacy.gbai	LGPD, GDPR, CCPA data subject rights
hipaa-medical.gbai	HIPAA/HITECH healthcare compliance

Finance

Template	Description
bank.gbai	Banking services bot
invoicing.gbai	Invoice generation and tracking

Platform

Template	Description
analytics-dashboard.gbai	Platform metrics and reports
bi.gbai	Business intelligence dashboards
talk-to-data.gbai	Natural language SQL queries
backup.gbai	Server backup automation

AI & LLM

Template	Description
llm-server.gbai	LLM model hosting
llm-tools.gbai	TOOL-based LLM examples
ai-search.gbai	AI-powered document search

---

Apps

HTMX web application templates for use with CREATE SITE.

Dashboard Templates

CREATE SITE "metrics", "bottemplates/apps/dashboard", "
Executive dashboard with:
- Revenue KPI cards
- Monthly trend charts
- Top performers table
"

CRUD Templates

CREATE SITE "contacts", "bottemplates/apps/crud", "
Contact management with:
- Searchable list view
- Add/edit forms
- Import/export buttons
"

Kanban Templates

CREATE SITE "projects", "bottemplates/apps/kanban", "
Project board with:
- Drag and drop cards
- Status columns
- Assignee filtering
"

Components

Reusable HTML components:

Component	File	Description
Data Table	data-table.html	Sortable, filterable tables
Form Modal	form-modal.html	Modal dialog with form
KPI Card	kpi-card.html	Metric display card
Chart	chart.html	Chart.js container
Search	search-filter.html	Search with filters

---

Prompts

System prompts and LLM configuration templates.

Assistant Prompts

Prompt	Description
sales.md	Sales assistant persona
support.md	Customer support agent
analyst.md	Data analyst assistant
developer.md	Technical assistant

Tool Templates

Templates for creating LLM-invokable tools:

' From bottemplates/dialogs/tools/template.bas
PARAM input AS STRING DESCRIPTION "Description of input"
DESCRIPTION "What this tool does. When to use it."

' Your tool logic here
result = PROCESS input
RETURN result

---

Dialogs

Reusable BASIC script patterns.

Authentication

' bottemplates/dialogs/auth/oauth-flow.bas
INCLUDE "bottemplates/dialogs/auth/oauth-flow.bas"

Notifications

' Send multi-channel notification
INCLUDE "bottemplates/dialogs/notifications/multi-channel.bas"
NOTIFY user, "Your order shipped!", channels: ["email", "whatsapp"]

Data Operations

' CRUD with validation
INCLUDE "bottemplates/dialogs/data/validated-crud.bas"
CREATE_VALIDATED "contacts", contact_data, validation_rules

---

Themes

UI customization packages.

Using a Theme

my-bot.gbai/
└── my-bot.gbtheme/    # Copy theme files here
    ├── colors.css
    ├── fonts.css
    └── components.css

Available Themes

Theme	Description
default	Clean, modern appearance
dark	Dark mode with accent colors
corporate	Professional business styling
minimal	Stripped-down, fast-loading

---

Bot Package Structure

Every .gbai bot follows this structure:

my-bot.gbai/
├── README.md                 # Documentation
├── my-bot.gbdialog/          # BASIC scripts
│   ├── start.bas             # Entry point
│   └── tools/                # LLM-invokable tools
├── my-bot.gbot/              # Configuration
│   └── config.csv            # Bot settings
├── my-bot.gbkb/              # Knowledge base (optional)
│   └── docs/                 # Documents for RAG
├── my-bot.gbdrive/           # File storage (optional)
└── my-bot.gbtheme/           # UI customization (optional)

---

Best Practices

Event-Driven Design

Use ON triggers instead of polling:

' ✅ Good - Event-driven
ON INSERT OF "leads"
    lead = GET LAST "leads"
    NOTIFY sales_team, "New lead: " + lead.name
END ON

' ❌ Bad - Polling loop
mainLoop:
    leads = FIND "leads", "new = true"
    WAIT 5
GOTO mainLoop

LLM-Invokable Tools

Add PARAM and DESCRIPTION to make scripts callable by LLM:

' score-lead.bas
PARAM email AS STRING LIKE "john@example.com" DESCRIPTION "Lead email"
PARAM company AS STRING DESCRIPTION "Company name"

DESCRIPTION "Score and qualify a sales lead"

score = AI SCORE LEAD email, company
RETURN score

HTMX Patterns

Generated apps should use HTMX for server communication:

<div hx-get="/api/data/leads"
     hx-trigger="load, every 30s"
     hx-swap="innerHTML">
    Loading...
</div>

---

Contributing

1. Fork this repository
2. Create your template following the structure
3. Test thoroughly
4. Add documentation
5. Submit a pull request

Template Checklist

• Follows naming conventions
• Includes README.md
• Uses event-driven patterns
• Has proper error handling
• Documented configuration options
• Example usage provided

---

License

AGPL-3.0 - Part of General Bots Open Source Platform

---

Pragmatismo - pragmatismo.com.br