Chapter 2: Architecture & Packages 🟡 BETA

Architecture and deployment reference for developers.

Overview

botserver is built in Rust with a modular architecture. Extend it by creating custom keywords, services, or entire applications.

Architecture

┌─────────────────────────────────────────┐
│              Web Server (Axum)          │
├─────────────────────────────────────────┤
│         BASIC Runtime (Rhai)            │
├──────────┬──────────┬──────────┬────────┤
│   LLM    │ Storage  │  Vector  │ Cache  │
│ Service  │ (MinIO)  │ (Qdrant) │(Valkey)│
├──────────┴──────────┴──────────┴────────┤
│            PostgreSQL                   │
└─────────────────────────────────────────┘

Deployment Options

MethodUse CaseGuide
LocalDevelopmentInstallation
DockerProductionDocker Deployment
LXCIsolated componentsContainer Deployment

Module Structure

ModulePurpose
web_serverHTTP/WebSocket handling
basicBASIC language runtime
llmLLM provider integration
driveObject storage
sharedDatabase models

Creating Custom Keywords

#![allow(unused)]
fn main() {
// In src/basic/keywords/my_keyword.rs
pub fn my_keyword(context: &mut EvalContext) -> Result<Dynamic, Box<EvalError>> {
    // Your keyword logic
    Ok(Dynamic::from("result"))
}
}

Register in keywords/mod.rs and rebuild.

Autonomous Task AI

General Bots enables autonomous task execution where the machine does the work:

Human describes intent → AI plans → AI generates → AI deploys → AI monitors

Key concepts:

  • Intent Compilation - LLM translates natural language to execution plans
  • CREATE SITE - Generates HTMX apps bound to botserver API
  • .gbdrive - Cloud-synced workspace for all task files
  • Autonomous Execution - System runs plans with approval gates

See Autonomous Task AI for complete documentation.

Chapter Contents

See Also