| .forgejo/workflows | ||
| .vscode | ||
| .zed | ||
| docs/src | ||
| gen/schemas | ||
| icons | ||
| migrations | ||
| prompts | ||
| scripts | ||
| src | ||
| templates | ||
| web | ||
| .gitignore | ||
| add-req.sh | ||
| build.rs | ||
| Cargo.lock | ||
| Cargo.toml | ||
| CHANGELOG.md | ||
| diesel.toml | ||
| fix-errors.sh | ||
| LICENSE | ||
| logo.png | ||
| README.md | ||
| tauri.conf.json | ||
General Bots - Enterprise-Grade LLM Orchestrator
A strongly-typed LLM conversational platform focused on convention over configuration and code-less approaches.
🚀 Quick Links
- Complete Documentation - Full documentation index
- Quick Start Guide - Get started in minutes
- Current Status - Production readiness (v6.0.8)
- Changelog - Version history
📚 Documentation Structure
All documentation has been organized into the docs/ directory:
Core Documentation (Numbered Chapters)
- Chapter 0: Introduction & Getting Started
- Chapter 1: Build & Development Status
- Chapter 2: Code of Conduct
- Chapter 3: Código de Conduta (PT-BR)
- Chapter 4: Contributing Guidelines
- Chapter 5: Integration Status
- Chapter 6: Security Policy
- Chapter 7: Production Status
Technical Documentation
- KB & Tools System - Core system architecture
- Security Features - Security implementation
- Semantic Cache - LLM caching with 70% cost reduction
- SMB Deployment - Small business deployment guide
- Universal Messaging - Multi-channel communication
Book-Style Documentation
- Detailed Docs - Comprehensive book-format documentation
🎯 What is General Bots?
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
🏆 Key Features
4 Essential Keywords
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
Strategic Advantages
- 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
🚀 Quick Start
Prerequisites
- Rust (latest stable) - Install from rustup.rs
- Git (latest stable) - Download from git-scm.com
Installation
# Clone the repository
git clone https://github.com/GeneralBots/BotServer
cd BotServer
# Run the server (auto-installs dependencies)
cargo run
On first run, BotServer automatically:
- Installs required components (PostgreSQL, MinIO, Redis, LLM)
- Sets up database with migrations
- Downloads AI models
- Uploads template bots
- Starts HTTP server at
http://127.0.0.1:8080
Management Commands
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 status
📊 Current Status
Version: 6.0.8
Build Status: ✅ SUCCESS
Production Ready: YES
Compilation: 0 errors
Warnings: 82 (all Tauri desktop UI - intentional)
See docs/07-STATUS.md for detailed status.
🤝 Contributing
We welcome contributions! Please read:
- Contributing Guidelines
- Code of Conduct
- Build Status for current development status
🔒 Security
Security issues should be reported to: security@pragmatismo.com.br
See docs/06-SECURITY.md for our security policy.
📄 License
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.
🌟 Key Facts
- ✅ 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
📞 Support & Resources
- Documentation: docs.pragmatismo.com.br
- GitHub: github.com/GeneralBots/BotServer
- Stack Overflow: Tag questions with
generalbots - Video Tutorial: 7 AI General Bots LLM Templates
🎬 Demo
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 img
👥 Contributors
General 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