Skip to content

GeneralBots/botbook

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

General Bots

General Bots Logo

Enterprise-Grade LLM Orchestrator & AI Automation Platform

A strongly-typed, self-hosted conversational platform focused on convention over configuration and code-less approaches.


πŸ—οΈ Architecture

General Bots Platform Architecture


πŸ“¦ Repositories

Repository Description Status
botserver Core API server - LLM orchestration, automation, integrations βœ… Production
botui Pure web UI - HTMX-based interface (suite & minimal) βœ… Production
botapp Tauri desktop wrapper - native file access, system tray βœ… Production
botlib Shared Rust library - common types, HTTP client, utilities βœ… Production
bottemplates Templates - bots, apps, prompts, UI components βœ… Production
botbook Documentation - mdBook format, multi-language βœ… Production

πŸš€ Quick Start

Prerequisites

Run the Server

# Clone and run
git clone https://github.com/GeneralBots/botserver
cd botserver
cargo run

On first run, botserver automatically:

  • Installs required components (PostgreSQL, S3 storage, Cache, LLM)
  • Sets up database with migrations
  • Downloads AI models
  • Starts HTTP server at http://127.0.0.1:8080

Run the Desktop App

# Clone botui (pure web)
git clone https://github.com/GeneralBots/botui
cd botui
cargo run  # Starts web server at :3000

# In another terminal, clone and run botapp (Tauri desktop)
git clone https://github.com/GeneralBots/botapp
cd botapp
cargo tauri dev

✨ Key Features

πŸ€– Multi-Vendor LLM API

Unified interface for OpenAI, Groq, Claude, Anthropic, and local models.

πŸ”§ MCP + LLM Tools Generation

Instant tool creation from code and functions - no complex configurations.

πŸ’Ύ Semantic Caching

Intelligent response caching achieving 70% cost reduction on LLM calls.

🌐 Web Automation Engine

Browser automation combined with AI intelligence for complex workflows.

πŸ“Š Enterprise Data Connectors

Native integrations with CRM, ERP, databases, and external services.

πŸ”„ Git-like Version Control

Full history with rollback capabilities for all configurations and data.


🎯 4 Essential Keywords

General Bots provides a minimal, focused system:

USE KB "knowledge-base"    ' Load knowledge base into vector database
CLEAR KB "knowledge-base"  ' Remove KB from session
USE TOOL "tool-name"       ' Make tool available to LLM
CLEAR TOOLS                ' Remove all tools from session

πŸ›οΈ Architecture Details

botserver (Core)

The main API server handling:

  • LLM orchestration and prompt management
  • Multi-channel communication (WhatsApp, Teams, Email, Web)
  • File storage and drive management
  • Task scheduling and automation
  • Authentication and authorization

botui (Web Interface)

Pure web UI with zero native dependencies:

  • Suite: Full-featured multi-app interface
  • Minimal: Lightweight single-page chat
  • HTMX-powered for minimal JavaScript
  • Works in any browser

botapp (Desktop)

Tauri wrapper adding native capabilities:

  • Local file system access
  • System tray integration
  • Native dialogs and notifications
  • Desktop-specific features

botlib (Shared Library)

Common Rust code shared across projects:

  • HTTP client for botserver communication
  • Shared types and models
  • Branding and configuration utilities
  • Error handling

πŸ”§ Development Setup

# Clone all repositories
git clone https://github.com/GeneralBots/botserver botserver
git clone https://github.com/GeneralBots/botui
git clone https://github.com/GeneralBots/botapp
git clone https://github.com/GeneralBots/botlib
git clone https://github.com/GeneralBots/botbook botbook

# Build all (from each directory)
cd botlib && cargo build
cd ../botserver && cargo build
cd ../botui && cargo build
cd ../botapp && cargo build

πŸ“– Documentation


πŸ†š Why General Bots?

vs. Alternative General Bots Advantage
ChatGPT/Claude Automates entire business processes, not just chat
n8n/Make Simpler approach with minimal programming
Microsoft 365 User control, not locked ecosystems
Salesforce Open-source AI orchestration connecting all systems

πŸ›‘οΈ Security

  • AGPL-3.0 License - True open source with contribution requirements
  • Self-hosted - Your data stays on your infrastructure
  • Enterprise-grade - 5+ years of stability
  • No vendor lock-in - Open protocols and standards

Report security issues to: security@pragmatismo.com.br


🀝 Contributing

We welcome contributions! See our Contributing Guidelines.

Contributors


πŸ“„ License

General Bots is licensed under AGPL-3.0.

According to our dual licensing model, this program can be used either under the terms of the GNU Affero General Public License, version 3, or under a proprietary license.

Copyright (c) pragmatismo.com.br. All rights reserved.


πŸ”— Links


Code Name: Guaribas (a city in Brazil, state of PiauΓ­)

"No one should have to do work that can be done by a machine." - Roberto Mangabeira Unger