A strongly-typed LLM conversational platform focused on convention over configuration and code-less approaches.
- Complete Documentation - Full documentation index
- Quick Start Guide - Get started in minutes
- Changelog - Version history
All documentation has been organized into the docs/ directory:
- Introduction & Getting Started
- Package System
- Knowledge Base Reference
- User Interface
- BASIC Dialogs
- Architecture Reference
- Configuration
- REST API Reference
- Security & Authentication
- KB & Tools System - Core system architecture
- Semantic Cache - LLM caching with 70% cost reduction
- Universal Messaging - Multi-channel communication
- External Services - Service integrations
General Bots is a self-hosted AI automation platform that provides:
- Multi-Vendor LLM API - Unified interface for OpenAI, Groq, Claude, Anthropic
- MCP + LLM Tools Generation - Instant tool creation from code/functions
- Semantic Caching - Intelligent response caching (70% cost reduction)
- Web Automation Engine - Browser automation + AI intelligence
- External Data APIs - Integrated services via connectors
- Enterprise Data Connectors - CRM, ERP, database native integrations
- Git-like Version Control - Full history with rollback capabilities
- Contract Analysis - Legal document review and summary
# Run with default settings (console UI enabled)
cargo run
# Run without console UI
cargo run -- --noconsole
# Run in desktop mode (Tauri)
cargo run -- --desktop
# Run without any UI
cargo run -- --noui
# Specify tenant
cargo run -- --tenant <tenant_name>
# LXC container mode
cargo run -- --container- Console UI is enabled by default - Shows real-time system status, logs, and file browser
- Minimal UI is served by default at
http://localhost:8080- Lightweight, fast-loading interface - Full suite UI available at
http://localhost:8080/suite- Complete multi-application interface - Use
--noconsoleto disable the terminal UI and run as a background service - The HTTP server always runs on port 8080 unless in desktop mode
General Bots provides a minimal, focused system for managing Knowledge Bases and Tools:
USE KB "kb-name" ' Load knowledge base into vector database
CLEAR KB "kb-name" ' Remove KB from session
USE TOOL "tool-name" ' Make tool available to LLM
CLEAR TOOLS ' Remove all tools from session- vs ChatGPT/Claude: Automates entire business processes, not just chat
- vs n8n/Make: Simpler approach with little programming needed
- vs Microsoft 365: User control, not locked systems
- vs Salesforce: Open-source AI orchestration connecting all systems
- Rust (latest stable) - Install from rustup.rs
- Git (latest stable) - Download from git-scm.com
# Clone the repository
git clone https://github.com/GeneralBots/BotServer
cd BotServer
# Run the server (auto-installs dependencies)
cargo runOn first run, BotServer automatically:
- Installs required components (PostgreSQL, S3-compatible storage, Cache, LLM)
- Sets up database with migrations
- Downloads AI models
- Uploads template bots
- Starts HTTP server at
http://127.0.0.1:8080
botserver start # Start all components
botserver stop # Stop all components
botserver restart # Restart all components
botserver list # List available components
botserver status <component> # Check component statusVersion: 6.0.8
Build Status: SUCCESS
Production Ready: YES
Compilation: 0 errors
General Bots supports deployment via LXC containers for isolated, lightweight virtualization:
# Deploy with LXC container isolation
cargo run -- --containerSee Container Deployment for detailed LXC setup instructions.
General Bots uses minimal environment configuration. Only Directory service variables are required:
| Variable | Purpose |
|---|---|
DIRECTORY_URL |
Zitadel instance URL |
DIRECTORY_CLIENT_ID |
OAuth client ID |
DIRECTORY_CLIENT_SECRET |
OAuth client secret |
All service credentials (database, storage, cache) are managed automatically by the Directory service. Application configuration is done through config.csv files in each bot's .gbot folder.
See Environment Variables for details.
We welcome contributions! Please read:
Security issues should be reported to: security@pragmatismo.com.br
See Security Policy for our security guidelines.
General Bot Copyright (c) pragmatismo.com.br. All rights reserved.
Licensed under the 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.
See LICENSE for details.
- LLM Orchestrator AGPL licensed (contribute back for custom-label SaaS)
- True community governance
- No single corporate control
- 5+ years of stability
- Never changed license
- Enterprise-grade
- Hosted locally or multicloud
- Documentation: docs.pragmatismo.com.br
- GitHub: github.com/GeneralBots/BotServer
- Stack Overflow: Tag questions with
generalbots - Video Tutorial: 7 AI General Bots LLM Templates
See conversational data analytics in action:
TALK "General Bots Labs presents FISCAL DATA SHOW BY BASIC"
result = GET "https://api.fiscaldata.treasury.gov/services/api/..."
data = SELECT YEAR(record_date) as Yr, SUM(...) AS Amount FROM data
img = CHART "bar", data
SEND FILE imgGeneral Bots 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